Tong Shu date selection API

Mỗi ngày trong khoảng được xác định thành cột ngày từ sexagenary cycle, sau đó được đọc qua hai register độc lập. Chu kỳ twelve day officers 建除十二值星 kết hợp với month branch, mỗi officer có danh sách riêng những gì phù hợp và những gì cấm: Full phù hợp cho ký kết và lễ hội, Close gần như không phù hợp gì. Chu kỳ twenty-eight lunar mansions chạy theo nhịp bảy ngày độc lập với officers, và có các endorsement riêng. Một ngày chỉ được chấp nhận khi hoạt động đã chọn vượt qua cả hai register. Bộ lọc clash tùy chọn sẽ loại bỏ các ngày có branch đối nghịch với con vật bạn chỉ định, cách truyền thống loại trừ người được chọn ngày. Phản hồi báo cáo số ngày đã quét, số ngày khớp và chi tiết những gì bị loại bỏ theo register và clash, vì vậy câu trả lời trống vẫn dễ hiểu hơn là bí ẩn.

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

Dùng nó trong quy trình đặt chỗ, lên kế hoạch sự kiện, sản phẩm đám cưới và địa điểm, lịch khám bệnh, hoặc bất cứ nơi nào bộ chọn ngày nên ưu tiên êm ái một số ngày so với những ngày khác. Vì nó trả về lý do chứ không chỉ verdict, bạn có thể cho người dùng biết tại sao thứ Ba thứ ba bị thiếu thay vì làm mờ nó im lặng. Đưa kết quả vào calendar component ngay, hoặc dùng các counts để quyết định có nên mở rộng window trước khi hỏi lại.

Cả hai register đều xuất phát từ truyền thống almanac in ấn chứ không phải từ xếp hạng tự tạo, và endpoint không bao giờ tự tạo ngày: kết quả trống vẫn trống và báo cáo register nào đã làm trống. Ranh giới ngày là 23:00, đồng nhất với mọi endpoint Trung Quốc khác ở đây. Tên hoạt động tuân theo danh sách của register, vì vậy hoạt động không biết sẽ bị từ chối với mã 400 kèm tên trường.