API do wyboru dat według almanachu Tong Shu
Przeskanuj okno dni i otrzymaj tylko te, które almanak zatwierdza dla konkretnego przedsięwzięcia, wraz z powodem, dla każdej pomyślnej daty, oraz zliczeniem odrzuconych i powodem odrzucenia.
API do wyboru dat według almanachu Tong Shu
Każdy dzień w oknie jest przypisany do swojej kolumny dziennej z cyklu sekstynaryjnego, a następnie sprawdzany w dwóch niezależnych rejestrach. Dwunastu urzędników 建除十二值星 cykluje z gałęzią miesiąca, a każdy ma własną listę tego, co jest odpowiednie i czego zabrania: Pełne odpowiednie podpisywanie i świętowanie, Prawie nic nie jest odpowiednie. Dwadzieścia osiem pałaców księżycowych cyklują siedmiodniowym rytmem niezależnie od urzędników i mają własne rekomendacje. Dzień jest dopuszczony tylko wtedy, gdy wybrana aktywność przejdzie oba rejestry. Opcjonalny filtr konfliktu usuwa dni, których gałąź stoi w opozycji do nazwanego przez Ciebie zwierzęcia, co jest tradycyjnym sposobem wykluczenia osoby, dla której dzień jest wybierany. Odpowiedź zgłasza przeskanowane, dopasowane oraz szczegółowe odrzucenia według rejestru i konfliktu, dzięki czemu pusta odpowiedź jest zrozumiała, a nie tajemnicza.
POST/v1/chinese/tong-shu/select
curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"from": "2026-06-01",
"to": "2026-06-14",
"activity": "marriage",
"avoidClashWith": "Horse"
}' {
"ok": true,
"data": {
"activity": "marriage",
"from": "2026-06-01",
"to": "2026-06-14",
"scanned": 14,
"matched": 5,
"dropped": { "byRegister": 9, "byClash": 0 },
"days": [
{
"date": "2026-06-02",
"verdict": "suitable",
"dayPillar": "Ding-Wei",
"officer": { "chinese": "滿", "name": "Full", "summary": "Fullness and return. Signing, opening, celebrating." },
"mansion": { "chinese": "尾", "name": "Tail", "quadrant": "Azure Dragon" },
"clashesWith": "Ox"
}
]
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| from | string (YYYY-MM-DD) | tak | First day of the window to scan. |
| to | string (YYYY-MM-DD) | tak | Last day of the window. |
| activity | string | tak | What the day is for: marriage, opening, moving, travel, medical, education, funeral and the rest of the register's own list. |
| avoidClashWith | string | nie | An animal name. Days whose branch clashes that animal are dropped, which is how the tradition excludes the person the day is for. |
| language | string | nie | Any of 21 codes for the animal names. |
Kiedy używać
Sięgnij po to w procesach rezerwacji, planowaniu wydarzeń, produktach ślubnych i lokacyjnych, harmonogramie klinicznym lub wszędzie tam, gdzie selektor dat powinien cicho preferować niektóre dni nad innymi. Ponieważ zwraca uzasadnienie, a nie tylko werdykt, możesz pokazać użytkownikowi, dlaczego trzecia wtorkowa jest brakująca, zamiast cicho ją wygaszać. Przekazaj wynik bezpośrednio do komponentu kalendarza lub użyj liczb, aby zdecydować, czy okno potrzebuje poszerzenia, zanim zapytasz ponownie.
Uwagi
Oba rejestry pochodzą z tradycji drukowanego almanaku, a nie z wymyślonego rankingu, a endpoint nigdy nie wymyśla dnia: pusty wynik pozostaje pusty i zgłasza, który rejestr go opróżni. Granica dnia to 23:00, zgodnie z każdym innym chińskim endpointem tutaj. Nazwy aktywności podążają za własną listą rejestru, więc nieznana aktywność jest odrzucana z błędem 400, który nazwie pole.
Wypróbuj API Wybór dat według almanachu Tong Shu
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.