API de compatibilité du zodiaque chinois

Chaque date est résolue à son année solaire, qui commence à l'instant du Li Chun tiré de l'éphéméride plutôt qu'au 1er janvier ou au Nouvel An chinois. Cette année donne la branche terrestre et son animal. Le score lit ensuite la relation entre les deux branches : les trines 三合, qui regroupent quatre ensembles de trois branches espacées uniformément autour du cercle, et les chocs 六冲, qui associent chaque branche à celle directement opposée. Les relations voisines et neutres se situent entre les deux. La réponse renvoie les deux animaux résolus, un score numérique, une catégorie et une courte note expliquant la signification de l'appariement, afin qu'une interface utilisateur puisse afficher le verdict sans avoir besoin d'une seconde table de correspondance.

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" }
  }'

{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}

Utilise-le lorsque tu veux un signal de compatibilité rapide et peu coûteux, basé uniquement sur une date : un filtre de rencontre, une carte partageable, un quiz, un widget marketing, une étape d'intégration où demander une heure de naissance te coûterait la conversion. C'est la lecture la plus grossière du catalogue et elle est honnête à ce sujet, car un animal de l'année ne connaît qu'un seul caractère sur les huit d'une personne. Lorsque le produit justifie une lecture réelle, prends le thème BaZi complet des deux personnes et examine plutôt les interactions entre les quatre piliers.

Le score est dérivé de la doctrine canonique 三合 et 六冲, et non d'une matrice d'opinions manuscrite, c'est pourquoi il est reproductible et s'explique de lui-même. Une naissance à moins d'un jour du Li Chun est le seul cas où l'heure compte : passe l'heure et le timezoneOffset et la limite est résolue à la seconde. Les noms d'animaux sont traduits en 21 langues ; le jeton anglais reste en place.