Tong Shu dátumválasztási API
Pásztázz egy időablakot és csak azokat a napokat kapod vissza, amelyeket a naptár jóváhagy egy adott tevékenységhez, azzal az indoklással, hogy miért maradt meg, és azzal, hogy mi lett elvetve és miért.
Tong Shu dátumválasztási API
Az ablak minden napját feloldja a 60 éves ciklusból származó napi oszlopra, majd két különálló regiszteren keresztül elemzi. A tizenkét napi tisztviselő (建除十二值星) ciklusban a hónap ágával együtt mozog, és mindegyiknek megvan a saját listája arról, hogy mire alkalmas és mit tilt: Teljesen alkalmas aláírásra és ünneplésre, Közel semmire. A huszonnyolc holdház ciklus hét napos ritmusban mozog, függetlenül a tisztviselőktől, és saját jóváhagyásokat hordoz. Egy nap csak akkor halad át, ha a kiválasztott tevékenység mindkét regiszteren átjut. Az opcionális ütközés szűrő eltávolítja azokat a napokat, amelyek ága ellentétes az állatéval, amit megnevezel, ez a hagyomány szerint kizárja azt a személyt, akinek a napját kiválasztják. A válasz jelentést ad a vizsgált, egyező napokról, és arról, hogy mi lett elvetve regiszterenként és ütközésenként, így egy üres válasz érthető, nem pedig rejtélyes.
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"
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| from | string (YYYY-MM-DD) | yes | First day of the window to scan. |
| to | string (YYYY-MM-DD) | yes | Last day of the window. |
| activity | string | yes | What the day is for: marriage, opening, moving, travel, medical, education, funeral and the rest of the register's own list. |
| avoidClashWith | string | no | 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 | no | Any of 21 codes for the animal names. |
When to use it
Használd foglalási folyamatokban, eseménytervezésben, esküvői és helyszín termékekben, klinikai időpontfoglalásban, vagy bárhol, ahol egy dátumválasztónak csendben kellene előnyben részesítenie egyes napokat másokkal szemben. Mivel az indoklást adja, nemcsak az ítéletet, megmutathatod a felhasználónak, hogy a harmadik kedd miért hiányzik ahelyett, hogy csendesen szürkére változtatnád. Táplázd az eredményt közvetlenül egy naptár komponensbe, vagy használd a számokat annak eldöntésére, hogy az időablakot szélesíteni kell-e, mielőtt újra kérnéd.
Notes
Mindkét regiszter a nyomtatott naptár hagyományából származik, nem feltalált rangsorolásból, és a végpont soha nem talál ki napot: egy üres eredmény üres marad és jelzi, melyik regiszter ürítette ki. A nap határa 23:00, összhangban az összes többi kínai végponttal itt. A tevékenység nevek a regiszter saját listáját követik, így egy ismeretlen tevékenység 400-as hibakóddal elutasításra kerül, amely megnevezi a mezőt.
Try the Tong Shu dátumválasztás API
Grab a key and make your first call in under a minute.