API di compatibilità dello zodiaco cinese

Ogni data viene risolta nel suo anno solare, che inizia all'istante Li Chun preso dalle efemeridi anziché il 1 gennaio o il Capodanno cinese. Quell'anno fornisce il ramo terrestre e il suo animale. Il punteggio poi legge la relazione tra i due rami: i 三合 tris, che raggruppano quattro insiemi di tre rami equamente spaziati intorno al cerchio, e i 六冲 scontri, che accoppiano ogni ramo con quello direttamente opposto. Le relazioni vicine e neutrali cadono tra questi. La risposta restituisce entrambi gli animali risolti, un punteggio numerico, una categoria e una breve nota che spiega cosa significa l'accoppiamento, in modo che un'interfaccia utente possa mostrare il verdetto senza una seconda tabella di ricerca.

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."]
    }
  }
}

Usalo quando vuoi un segnale di compatibilità rapido ed economico basato solo su una data: un filtro di matchmaking, una card condivisibile, un quiz, un widget di marketing, un passaggio di onboarding in cui chiedere l'ora di nascita ti costerebbe la conversione. È la lettura più grossolana del catalogo e lo ammette apertamente, poiché un animale dell'anno conosce esattamente un carattere su otto di una persona. Quando il prodotto merita una lettura reale, prendi il grafico completo BaZi per entrambe le persone e guarda le interazioni attraverso tutti e quattro i pilastri.

Il punteggio deriva dalla dottrina canonica 三合 e 六冲, non da una matrice di opinioni scritta a mano, per cui è riproducibile e si spiega da sola. Una nascita entro un giorno da Li Chun è l'unico caso in cui l'ora conta: passa il tempo e timezoneOffset e il limite viene risolto al secondo. I nomi degli animali si traducono in 21 lingue; il token inglese rimane al suo posto.