Tong Shu tarih seçimi API'si
Bir gün aralığını tarayın ve sadece takvimin belirli bir iş için onayladığı günleri, her birinin neden seçildiğini ve nelerin neden elendiğini gösteren bir sayımla geri alın.
Tong Shu tarih seçimi API'si
Aralıktaki her gün, altmışlık döngüden gün sütununa çözümlenir, ardından iki bağımsız kayıt defteri aracılığıyla okunur. On iki gün memuru 建除十二值星, ay dalı ile döngü yapar ve her biri neye uygun olduğunu ve neyi yasakladığını gösteren kendi listesini taşır: 'Full' imzalama ve kutlamaya uygunken, 'Close' neredeyse hiçbir şeye uygun değildir. Yirmi sekiz ay konağı, memurlardan bağımsız olarak yedi günlük bir ritimle döngü yapar ve kendi onaylarını taşır. Bir gün, ancak seçilen etkinlik her iki kayıt defterinden de geçtiğinde kabul edilir. İsteğe bağlı çakışma filtresi, adını verdiğiniz hayvana zıt duran dalı olan günleri kaldırır; gelenek, günün seçildiği kişiyi bu şekilde dışlar. Yanıt, taranan, eşleşen ve kayıt defterine ve çakışmaya göre nelerin elendiğinin dökümünü rapor eder, böylece boş bir cevap gizemli olmaktan ziyade anlaşılır olur.
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
Rezervasyon akışlarında, etkinlik planlamasında, düğün ve mekan ürünlerinde, klinik randevu planlamasında veya bir tarih seçicinin bazı günleri diğerlerine sessizce tercih etmesi gereken her yerde kullanabilirsin. Sadece kararı değil, gerekçeyi de döndürdüğü için, üçüncü Salı'nın neden eksik olduğunu kullanıcıya sessizce grileştirmek yerine gösterebilirsin. Sonucu doğrudan bir takvim bileşenine besleyebilir veya tekrar sormadan önce aralığın genişletilmesi gerekip gerekmediğine karar vermek için sayıları kullanabilirsin.
Notes
Her iki kayıt defteri de uydurulmuş bir sıralamadan ziyade basılı takvim geleneğinden gelir ve uç nokta asla bir gün icat etmez: boş bir sonuç boş kalır ve hangi kayıt defterinin onu boşalttığını bildirir. Gün sınırı 23:00'tür, buradaki diğer tüm Çin uç noktalarıyla tutarlıdır. Etkinlik adları kayıt defterinin kendi listesini takip eder, bu nedenle bilinmeyen bir etkinlik, alanı belirten bir 400 hatasıyla reddedilir.
Try the Tong Shu tarih seçimi API
Grab a key and make your first call in under a minute.