AstroWay/api v2.173.1 · ja
すべてのシステムが正常です
// astrology api · POST /v1/chinese/tong-shu/select

Tong Shu date selection API

特定な行為に対して、天体暦が認める日だけを、理由と共に返します。

Endpoint
POST /v1/chinese/tong-shu/select
Cost
20 credits
Latency
~110 ms
Tier
Tier 2
// 01 / What it computes

Tong Shu date selection API

毎日は、 sexagenary cycle の日柱に解決され、2 つの独立したレジスタを通じて読み取られます。十二日官 建除十二值星 のサイクルは月の枝と連動し、それぞれが適合するものと禁忌とするもののリストを持っています。二十八星宿は、官とは独立した 7 日のリズムでサイクルし、それぞれが独自の認可を持ちます。選択された活動が両方のレジスタを通過する場合にのみ、日が通過します。オプションのクラッシュフィルタは、指定された動物の反対の枝を持つ日を除外します。これは、選択された日が誰に適しているかを伝えるために使用されます。レスポンスは、スキャンされた、一致した、そしてレジスタとクラッシュによるドロップの分解を報告します。空の答えは、不明瞭ではなく読みやすいように残ります。

// 02 / Live request

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"
  }'
Response (excerpt)
{
  "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"
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

予約フロー、イベント計画、結婚や会場の製品、クリニックのスケジュール、日付ピッカーが静かに特定の日を優先するべき状況など、日付ピッカーが日付を優先するべき状況では、手を伸ばしてください。判決だけでなく理由も返すので、ユーザーに 3 日目の火曜日が欠けている理由を表示できます。結果を直接カレンダー コンポーネントにフィードするか、カウントを使用して、ウィンドウが拡大する必要があるかどうかを判断するために使用できます。

// 05 / Notes

Notes

両方のレジスタは、印刷された天体暦の伝統からではなく、創作されたランキングではなく、エンドポイントは日を作成せず、空の結果は空のまま報告します。日境界は 23:00 です。すべての中国エンドポイントと一致しています。活動名は、レジスタのリストに従うので、未知の活動は 400 のエラーで、フィールド名を含めて拒否されます。

Try the Tong Shu date selection API

Grab a key and make your first call in under a minute.

99.9% SLA · 有料プラン · 30日間 ステータス →