Tong Shu datumselectie API

Elke dag in het venster wordt omgezet naar zijn dagpaal uit de zestigjarige cyclus, vervolgens gelezen via twee onafhankelijke registers. De twaalf dagofficieren 建除十二值星 cycleren met de maandtak en elk heeft zijn eigen lijst van wat geschikt is en wat verboden is: Volledige geschiktheid voor ondertekening en viering, bijna geen geschiktheid voor dicht. De achtentwintig maansferen cycleren op een zeven-daags ritme onafhankelijk van de officieren, en hebben hun eigen goedkeuringen. Een dag gaat alleen door als de gekozen activiteit beide registers overleeft. De optionele clash-filter verwijdert vervolgens dagen wiens tak tegenover het dier staat dat je noemt, wat de traditie is om de persoon uit te sluiten voor wie de dag wordt gekozen. Het antwoord rapporteert gescand, gematcht en de verdeling van wat werd verwijderd per register en per clash, dus een leeg antwoord is begrijpelijk in plaats van mysterieus.

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

Grijp het bij boekingsstromen, evenementenplanning, bruiloft en locatieproducten, kliniekplanning, of overal waar een datumkiezer stilstandig sommige dagen boven anderen zou moeten prefereren. Omdat het de redenering teruggeeft en niet alleen het oordeel, kun je een gebruiker laten zien waarom de derde dinsdag ontbreekt in plaats van deze stilzwart uit te doven. Voer het resultaat direct in een kalendercomponent in, of gebruik de tellingen om te beslissen of het venster verbreding nodig heeft voordat je opnieuw vraagt.

Beide registers komen uit de gedrukte almanactraditie in plaats van uit een verzonnen rangschikking, en de endpoint verzon nooit een dag: een leeg resultaat blijft leeg en rapporteert welk register het leeggemaakt heeft. De daggrens is 23:00, consistent met elke andere Chinese endpoint hier. Activiteitsnamen volgen de eigen lijst van het register, dus een onbekende activiteit wordt geweigerd met een 400 die het veld noemt.