AstroWay/api v2.173.1 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/chinese/zodiac/compatibility

API de compatibilitate a zodiacului chinezesc

Două date de naștere introduse, o potrivire notată rezultată, construită pe geometria celor doisprezece ramuri în loc de un tabel de opinii. Animalul anului este determinat la exactul instant Li Chun, așa că o naștere în februarie corespunde animalului care îi aparține cu adevărat.

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

API de compatibilitate a zodiacului chinezesc

Fiecare dată este rezolvată la anul său solar, care începe la instantul Li Chun preluat din ephemeris și nu la 1 ianuarie sau la Anul Nou Chinez. Acest an dă ramura pământească și animalul corespunzător. Scorul apoi citește relația dintre cele două ramuri: 三合 trinele, care grupează patru seturi de trei ramuri egal spațiate pe cerc, și 六冲 conflictele, care asociază fiecare ramura cu cea direct opusă. Relațiile vecine și neutre se situează între ele. Răspunsul returnează ambele animale rezolvate, un scor numeric, o categorie și o notă scurtă care explică ce înseamnă perechea, astfel încât un UI poate afișa verdictul fără a necesita o a doua tabelă de căutare.

// 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

Folosește-l când dorești un semnal rapid și ieftin de compatibilitate, bazat doar pe o dată: un filtru de potrivire, o card partajabil, un quiz, un widget de marketing, un pas de onboarding unde solicitarea orei nașterii te-ar costa conversia. Este cea mai grosolană interpretare din catalog și este sinceră în acest sens, deoarece un animal de an cunoaște exact un caracter din optul unei persoane. Când produsul merită o interpretare reală, ia diagrama completă BaZi pentru ambele persoane și examinează interacțiunile din toate cele patru piloni.

// 05 / Notes

Notes

Scorul este derivat din doctrina canonică 三合 și 六冲, nu din o matrice de opinii scrisă manual, de aceea este reproductibil și se explică singur. O naștere în decurs de o zi de Li Chun este singurul caz în care ora contează: trece timpul și timezoneOffset și granița este rezolvată la secundă. Numele animalelor se traduc în 21 de limbi; token-ul englez rămâne în loc.

Try the Compatibilitatea zodiacului chinezesc API

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

99,9% SLA · planuri plătite · 30 zile status →