API pro výběr data Tong Shu
Prohledej rozsah dnů a získej zpět pouze ty, které almanach doporučuje pro konkrétní činnost, s důvodem, proč každý přeživší přežil, a počtem toho, co bylo vyřazeno a proč.
API pro výběr data Tong Shu
Každý den v rozsahu je převeden na svůj denní pilíř ze šedesátiletého cyklu a poté je přečten dvěma nezávislými registry. Dvanáct denních úředníků 建除十二值星 cykluje s měsíční větví a každý z nich nese svůj vlastní seznam toho, co se hodí a co zakazuje: Plný se hodí pro podepisování a oslavy, Těsný se nehodí téměř pro nic. Dvacet osm lunárních sídel cykluje v sedmidenním rytmu nezávisle na úřednících a nese svá vlastní doporučení. Den projde pouze tehdy, když zvolená aktivita přežije oba registry. Volitelný filtr střetů pak odstraní dny, jejichž větev stojí proti zvířeti, které jmenuješ, což je způsob, jakým tradice vylučuje osobu, pro kterou je den vybírán. Odpověď uvádí naskenované, shodné a rozpis toho, co bylo vyřazeno podle registru a podle střetu, takže prázdná odpověď je čitelná, spíše než záhadná.
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
Použij to v rezervačních procesech, plánování událostí, svatebních a místních produktech, plánování klinik nebo kdekoli, kde by výběr data měl tiše preferovat některé dny před jinými. Protože vrací zdůvodnění a nejen verdikt, můžeš uživateli ukázat, proč třetí úterý chybí, spíše než ho tiše zašednout. Vlož výsledek přímo do kalendářní komponenty, nebo použij počty k rozhodnutí, zda je třeba rozsah rozšířit, než se zeptáš znovu.
Notes
Oba registry pocházejí z tištěné almanachové tradice, spíše než z vymyšleného žebříčku, a endpoint nikdy nevymýšlí den: prázdný výsledek zůstává prázdný a hlásí, který registr ho vyprázdnil. Hranice dne je 23:00, v souladu s každým dalším čínským endpointem zde. Názvy aktivit se řídí vlastním seznamem registru, takže neznámá aktivita je odmítnuta s chybou 400, která pojmenuje pole.
Try the Výběr data Tong Shu API
Grab a key and make your first call in under a minute.