AstroWay/api v2.173.1 · nl
alle systemen normaal
// astrology api · POST /v1/chinese/zodiac/compatibility

Chinese dierenriem compatibiliteit API

Twee geboortedaten in, een beoordeelde match uit, gebaseerd op de geometrie van de twaaltakken in plaats van op een tabel met meningen. Het jaar dier wordt bepaald op het exacte Li Chun moment, dus een februari geboorte valt in het dier waar het eigenlijk bij hoort.

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

Chinese dierenriem compatibiliteit API

Elke datum wordt omgezet naar zijn zonnejaar, dat begint op het Li Chun moment uit de ephemeris in plaats van op 1 januari of op Chinees Nieuwjaar. Dat jaar geeft de aardtak en het dier. De score leest dan de relatie tussen de twee takken: de 三合 driehoeken, die vier groepen van drie takken groeperen die gelijkmatig rond de cirkel zijn verdeeld, en de 六冲 tegenstellingen, die elke tak paren met de er direct tegenoverliggende. Buren en neutrale relaties vallen daartussenin. Het antwoord geeft beide omgezette dieren, een numerieke score, een categorie en een korte notitie die uitlegt wat de betekenis van de combinatie is, zodat een UI het oordeel kan tonen zonder een tweede opzoektafel.

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

Grijp het aan als je een snelle, goedkope compatibiliteitsindicator wilt gebaseerd op alleen een datum: een matchfilter, een deelbare kaart, een quiz, een marketingwidget, een onboardingsstap waar het vragen naar een geboortetijd je de conversie zou kosten. Het is de meest grove lezing in de catalogus en het is eerlijk over dat, omdat een jaardier precies één karakter van een persoon van de acht kent. Wanneer het product een echte lezing rechtvaardigt, neem dan de volledige BaZi kaart voor beide personen en kijk naar de interacties over alle vier de pilaren in plaats daarvan.

// 05 / Notes

Notes

De score is afgeleid van 三合 en 六冲 canonische doctrine, niet van een handgeschreven meningenmatrix, wat het reproduceerbaar en zelfverklarend maakt. Een geboorte binnen een dag van Li Chun is het enige geval waar het uur ertoe doet: geef tijd en timezoneOffset en de grens wordt tot op de seconde bepaald. Dierennamen vertalen zich naar 21 talen; het Engelse token blijft op zijn plaats.

Try the Chinese dierenriem compatibiliteit API

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

99.9% SLA · betaalde plannen · 30d status →