API de sélection de dates Tong Shu

Chaque jour de la fenêtre est résolu en son pilier du jour du cycle sexagésimal, puis lu à travers deux registres indépendants. Le cycle des douze officiers du jour 建除十二值星 avec la branche du mois, chacun possède sa propre liste de ce qu’il convient et de ce qu’il interdit : Full convient à la signature et à la célébration, Close convient à presque rien. Le cycle des vingt-huit demeures lunaires suit un rythme de sept jours indépendant des officiers, et possède ses propres agréments. Un jour ne passe que si l’activité choisie survit aux deux registres. Le filtre de conflit optionnel enlève les jours dont la branche est opposée à l’animal que tu nommes, c’est ainsi que la tradition exclut la personne pour qui le jour est choisi. La réponse indique le nombre de jours scannés, correspondants et la répartition de ce qui a été écarté par registre et par conflit, ainsi une réponse vide reste lisible plutôt que mystérieuse.

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

Utilise-le dans les flux de réservation, la planification d’événements, les produits de mariage et de lieux, la prise de rendez-vous en clinique, ou partout où un sélecteur de dates doit discrètement privilégier certains jours. Comme il renvoie le raisonnement et pas seulement le verdict, tu peux montrer à l’utilisateur pourquoi le troisième mardi manque au lieu de le griser silencieusement. Alimente directement un composant calendrier avec le résultat, ou utilise les décomptes pour décider si la fenêtre doit être élargie avant de relancer la requête.

Les deux registres proviennent de la tradition de l’almanach imprimé plutôt que d’un classement inventé, et l’endpoint n’invente jamais de jour : un résultat vide reste vide et indique quel registre l’a vidé. La limite du jour est à 23 h, cohérente avec tous les autres endpoints chinois ici. Les noms d’activités suivent la liste propre au registre, ainsi une activité inconnue est refusée avec un 400 qui indique le champ.