API de selección de fechas Tong Shu

Cada día en el período se resuelve a su pilar del día del ciclo sexagenario, luego se lee a través de dos registros independientes. Los doce oficiales del día 建除十二值星 ciclan con la rama del mes y cada uno lleva su propia lista de lo que le conviene y lo que prohíbe: 'Full' conviene para firmar y celebrar, 'Close' casi para nada. Las veintiocho mansiones lunares ciclan en un ritmo de siete días independiente de los oficiales, y llevan sus propias aprobaciones. Un día pasa solo cuando la actividad elegida sobrevive a ambos registros. El filtro de choque opcional luego elimina los días cuya rama se opone al animal que nombras, que es como la tradición excluye a la persona para la que se elige el día. La respuesta informa los días escaneados, los coincidentes y el desglose de lo que se descartó por registro y por choque, para que una respuesta vacía sea legible en lugar de misteriosa.

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

Úsalo en flujos de reserva, planificación de eventos, productos para bodas y lugares, programación de clínicas, o en cualquier lugar donde un selector de fechas deba preferir discretamente algunos días sobre otros. Debido a que devuelve el razonamiento y no solo el veredicto, puedes mostrar a un usuario por qué falta el tercer martes en lugar de simplemente atenuarlo en silencio. Introduce el resultado directamente en un componente de calendario, o usa los recuentos para decidir si el período necesita ampliarse antes de volver a preguntar.

Ambos registros provienen de la tradición del almanaque impreso en lugar de una clasificación inventada, y el endpoint nunca inventa un día: un resultado vacío permanece vacío e informa qué registro lo vació. El límite del día es a las 23:00, consistente con todos los demás endpoints chinos aquí. Los nombres de las actividades siguen la propia lista del registro, por lo que una actividad desconocida es rechazada con un 400 que nombra el campo.