Tong Shu date selection API
特定な行為に対して、天体暦が認める日だけを、理由と共に返します。
Tong Shu date selection API
毎日は、 sexagenary cycle の日柱に解決され、2 つの独立したレジスタを通じて読み取られます。十二日官 建除十二值星 のサイクルは月の枝と連動し、それぞれが適合するものと禁忌とするもののリストを持っています。二十八星宿は、官とは独立した 7 日のリズムでサイクルし、それぞれが独自の認可を持ちます。選択された活動が両方のレジスタを通過する場合にのみ、日が通過します。オプションのクラッシュフィルタは、指定された動物の反対の枝を持つ日を除外します。これは、選択された日が誰に適しているかを伝えるために使用されます。レスポンスは、スキャンされた、一致した、そしてレジスタとクラッシュによるドロップの分解を報告します。空の答えは、不明瞭ではなく読みやすいように残ります。
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
予約フロー、イベント計画、結婚や会場の製品、クリニックのスケジュール、日付ピッカーが静かに特定の日を優先するべき状況など、日付ピッカーが日付を優先するべき状況では、手を伸ばしてください。判決だけでなく理由も返すので、ユーザーに 3 日目の火曜日が欠けている理由を表示できます。結果を直接カレンダー コンポーネントにフィードするか、カウントを使用して、ウィンドウが拡大する必要があるかどうかを判断するために使用できます。
Notes
両方のレジスタは、印刷された天体暦の伝統からではなく、創作されたランキングではなく、エンドポイントは日を作成せず、空の結果は空のまま報告します。日境界は 23:00 です。すべての中国エンドポイントと一致しています。活動名は、レジスタのリストに従うので、未知の活動は 400 のエラーで、フィールド名を含めて拒否されます。
Try the Tong Shu date selection API
Grab a key and make your first call in under a minute.