AstroWay/api v2.258.3 · id
semua sistem normal
// astrology api · POST /v1/chinese/zodiac/compatibility

API kompatibilitas zodiak Tiongkok

Dua tanggal lahir masuk, kecocokan ter skor keluar, dibangun berdasarkan geometri dua belas cabang daripada tabel pendapat. Hewan tahun ditentukan pada tepat saat Li Chun, sehingga kelahiran Februari jatuh pada hewan yang sebenarnya dimilikinya.

Endpoint
POST /v1/chinese/zodiac/compatibility
Cost
10 credits
Latency
~60 ms
Tier
Tier 1
// 01 / What it computes

API kompatibilitas zodiak Tiongkok

Setiap tanggal ditentukan ke tahun surya, yang dimulai pada saat Li Chun diambil dari efemeris daripada pada 1 Januari atau Tahun Baru Tiongkok. Tahun tersebut memberikan cabang bumi dan hewannya. Skor kemudian membaca hubungan antara dua cabang: 三合 trines, yang mengelompokkan empat set tiga cabang yang terdistribusi merata di sekitar lingkaran, dan 六冲 clashes, yang memasangkan setiap cabang dengan yang berlawanan secara langsung. Hubungan tetangga dan netral berada di antaranya. Respon mengembalikan kedua hewan yang ditentukan, skor numerik, kategori, dan catatan singkat yang menjelaskan apa arti pasangan tersebut, sehingga UI dapat menampilkan veredik tanpa tabel pencarian kedua.

// 02 / Live request

POST/v1/chinese/zodiac/compatibility

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "person1": { "date": "1990-05-15" },
    "person2": { "date": "1988-02-20" }
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
person1.date string (YYYY-MM-DD) yes First birth date. The animal comes from the solar year, which opens at Li Chun, not at New Year.
person2.date string (YYYY-MM-DD) yes Second birth date.
person1.time string (HH:MM:SS) no Only matters for a birth within a day of Li Chun, where the hour decides the year.
person1.timezoneOffset number (hours) no The UTC offset the clock was on. Used with time to place a boundary birth.
person1.solarYear number no Override the resolved year outright when you already hold it.
language string no Any of 21 codes. Adds animalName next to the English token; the English fields do not move.
// 04 / When to use it

When to use it

Gunakan ketika Anda ingin sinyal kompatibilitas yang cepat dan murah yang hanya terkait dengan tanggal: filter pencarian pasangan, kartu yang bisa dibagikan, kuis, widget pemasaran, langkah onboarding di mana meminta waktu kelahiran akan membuat Anda kehilangan konversi. Ini adalah bacaan paling kasar dalam katalog dan jujur tentang itu, karena hewan tahun hanya mengetahui satu karakter dari delapan karakter seseorang. Ketika produk memerlukan bacaan yang sebenarnya, ambil diagram BaZi lengkap untuk kedua orang dan lihat interaksi di semua empat pilar sebagai gantinya.

// 05 / Notes

Notes

Skor berasal dari doktrin kanonik 三合 dan 六冲, bukan dari matriks pendangan yang ditulis tangan, itulah mengapa dapat direproduksi dan menjelaskan dirinya sendiri. Kelahiran dalam sehari dari Li Chun adalah satu-satunya kasus di mana jam penting: berikan waktu dan timezoneOffset dan batas ditentukan hingga detik. Nama hewan diterjemahkan ke 21 bahasa; token Inggris tetap ada.

Try the Kompatibilitas zodiak Tiongkok API

Grab a key and make your first call in under a minute.

99.9% SLA · paket berbayar · 30d status →