API zgodności chińskiego zodiaku
Wprowadzasz dwie daty urodzenia, otrzymujesz oceniony dopasowanie, oparte na geometrii dwunastu gałęzi, a nie na tabeli opinii. Zwierzę roku jest ustalane w dokładnym momencie Li Chun, więc urodzenie w lutym przypisuje się właściwemu zwierzęciu.
API zgodności chińskiego zodiaku
Każda data jest przeliczana na swój rok słoneczny, który zaczyna się w momencie Li Chun pobranym z efemerydy, a nie 1 stycznia ani Chińskiego Nowego Roku. Ten rok określa ziemską gałąź i jej zwierzę. Wynik odczytuje relację między dwiema gałęziami: trójki 三合, które grupują cztery zestawy trzech gałęzi równomiernie rozmieszczonych wokół koła, oraz konflikty 六冲, które łączą każdą gałąź z przeciwległą. Sąsiednie i neutralne relacje leżą pomiędzy. Odpowiedź zwraca oba rozpoznane zwierzęta, liczbowy wynik, kategorię i krótką notatkę wyjaśniającą, co oznacza połączenie, dzięki czemu UI może pokazać werdykt bez dodatkowej tabeli.
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" }
}'{
"ok": true,
"data": {
"person1": { "solarYear": 1990, "animal": "Horse" },
"person2": { "solarYear": 1988, "animal": "Dragon" },
"compatibility": {
"score": 65,
"category": "good",
"notes": ["Compatible enough; complementary differences."]
}
}
}Parametry
| name | type | Wymagane | |
|---|---|---|---|
| person1.date | string (YYYY-MM-DD) | tak | 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) | tak | Second birth date. |
| person1.time | string (HH:MM:SS) | nie | Only matters for a birth within a day of Li Chun, where the hour decides the year. |
| person1.timezoneOffset | number (hours) | nie | The UTC offset the clock was on. Used with time to place a boundary birth. |
| person1.solarYear | number | nie | Override the resolved year outright when you already hold it. |
| language | string | nie | Any of 21 codes. Adds animalName next to the English token; the English fields do not move. |
Kiedy używać
Użyj tego, gdy potrzebujesz szybkiego, taniego sygnału zgodności opartego tylko na dacie: filtr dopasowań, karta do udostępnienia, quiz, widget marketingowy, krok w onboardingzie, gdzie pytanie o godzinę urodzenia kosztowałoby konwersję. To najogólniejjsze odczyt w katalogu i jest o tym szczery, bo zwierzę roku zna dokładnie jedną cechę z ośmiu osoby. Gdy produkt wymaga prawdziwego odczytu, weź pełny wykres BaZi obu osób i przyjrzyj się interakcjom we wszystkich czterech filarach zamiast tego.
Uwagi
Wynik pochodzi z kanonicznej doktryny 三合 i 六冲, a nie z ręcznie pisanego macierzy opinii, dlatego jest powtarzalny i sam się wyjaśnia. Urodzenie w ciągu dnia od Li Chun to jedyny przypadek, gdy godzina ma znaczenie: podaj time i timezoneOffset, a granica jest ustalana do sekundy. Nazwy zwierząt są tłumaczone na 21 języków; token po angielsku pozostaje bez zmian.
Wypróbuj API Zgodność chińskiego zodiaku
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.