واجهة برمجة تطبيقات اختيار تاريخ Tong Shu

كل يوم في النافذة يُحل إلى عموده اليومي من دورة الستين سنة، ثم يُقرأ عبر سجلين مستقلين. دورة اثني عشر ضابط اليوم 建除十二值星 مع فرع الشهر وكل واحد يحمل قائمته الخاصة بما يناسبه وما يمنعه: الكامل يناسب التوقيع والاحتفال، القريب لا يناسب تقريبًا شيئًا. دورة الأحياء القمرية الثمانية والعشرين على إيقاع سبعة أيام مستقلة عن الضباط، وتحمل تأييداتها الخاصة. يمر اليوم فقط عندما ينجو النشاط المختار من كلا السجلين. ثم يزيل مرشح الصدام الاختياري الأيام التي يكون فرعها معارضًا للحيوان الذي تسميه، وهو ما تستبعد به التقليد الشخص الذي يُختار له اليوم. التقرير يُظهر عدد الأيام الممسوحة، المتطابقة وتفصيل ما تم إسقاطه حسب السجل وحسب الصدام، لذا يكون الجواب الفارغ مقروءًا بدلاً من غامض.

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"
      }
    ]
  }
}

استخدمه في تدفقات الحجز، تخطيط الفعاليات، منتجات الزفاف والمكان، جدولة العيادات، أو أي مكان يجب فيه لمحدد التاريخ أن يفضّل بعض الأيام على غيرها بهدوء. لأنّه يُعيد السبب وليس فقط الحكم، يمكنك إظهار للمستخدم لماذا الثلاثاء الثالث مفقود بدلاً من إخفائه بصمت. ضع النتيجة مباشرة في مكوّن تقويم، أو استخدم العدادات لتقرر ما إذا كان يجب توسيع النافذة قبل أن تسأل مرة أخرى.

كلا السجلين يأتيان من تقليد التقويم المطبوع وليس من ترتيب مُختلق، ولا يُخترع الendpoint يومًا: النتيجة الفارغة تظل فارغة وتُبلغ أي سجل أفرغها. حدّ اليوم هو 23:00، متسق مع كل الendpoint صينية أخرى هنا. أسماء الأنشطة تتبع قائمة السجل نفسها، لذا يُرفض نشاط غير معروف برمز 400 يذكر الحقل.