Tong Shu Datumsauswahl API

Jeder Tag im Fenster wird zu seiner Tagessäule aus dem sexagenären Zyklus aufgelöst und dann durch zwei unabhängige Register gelesen. Der zwölf-tägige Officer-Zyklus 建除十二值星 zusammen mit dem Monatszweig, wobei jeder seine eigene Liste von passenden und verbotenen Dingen hat: "Full" passt zum Unterschreiben und Feiern, "Close" fast zu nichts. Der 28-teilige Mond-Mansions-Zyklus läuft im Sieben-Tage-Rhythmus unabhängig von den Offizieren und hat eigene Empfehlungen. Ein Tag gilt nur, wenn die gewählte Aktivität beide Register übersteht. Der optionale Clash-Filter entfernt Tage, deren Zweig dem von dir genannten Tier entgegengesetzt ist – so schließt die Tradition die Person aus, für die der Tag gewählt wird. Die Antwort gibt gescannte, passende und die Aufschlüsselung dessen, was durch Register und Clash verworfen wurde, sodass eine leere Antwort lesbar statt mysteriös ist.

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

Nutze es bei Buchungsabläufen, Event-Planung, Hochzeits- und Veranstaltungsprodukten, Klinik-Terminplanung oder überall dort, wo ein Datumsauswahl-Feld leise manche Tage anderen vorziehen soll. Da es die Begründung und nicht nur das Urteil zurückgibt, kannst du dem Nutzer zeigen, warum der dritte Dienstag fehlt, anstatt ihn still zu deaktivieren. Füttere das Ergebnis direkt in eine Kalender-Komponente ein oder nutze die Zählungen, um zu entscheiden, ob das Zeitfenster erweitert werden muss, bevor du erneut fragst.

Beide Register stammen aus der gedruckten Almanach-Tradition und nicht aus einer erfundenen Rangliste, und der endpoint erfindet nie einen Tag: Ein leeres Ergebnis bleibt leer und meldet, welches Register es geleert hat. Die Tagesgrenze ist 23:00, konsistent mit allen anderen chinesischen endpoint hier. Aktivitätsnamen folgen der eigenen Liste des Registers, sodass eine unbekannte Aktivität mit einem 400-Fehler abgelehnt wird, der das Feld nennt.