API de seleção de datas Tong Shu

Cada dia na janela é resolvido para o seu pilar diário a partir do ciclo sexagenário, depois lido através de dois registos independentes. O ciclo dos doze oficiais do dia 建除十二值星 com o ramo do mês, e cada um tem a sua própria lista do que permite e do que proíbe: Full permite assinar e celebrar, Close permite quase nada. O ciclo das vinte-e-oito mansões lunares segue um ritmo de sete dias independente dos oficiais, e tem as suas próprias aprovações. Um dia só passa quando a atividade escolhida sobrevive a ambos os registos. O filtro opcional de conflito remove então os dias cujo ramo está oposto ao animal que tu nomeias, que é como a tradição exclui a pessoa para quem o dia está a ser escolhido. A resposta indica os dias analisados, correspondidos e a repartição do que foi descartado por registo e por conflito, para que uma resposta vazia seja legível e não 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"
      }
    ]
  }
}

Usa-o em fluxos de reserva, planeamento de eventos, produtos de casamentos e locais, agendamento de clínicas, ou onde quer que um selector de datas deva preferir silenciosamente alguns dias a outros. Como devolve o raciocínio e não só o veredicto, podes mostrar ao utilizador porque é que a terceira terça-feira falta em vez de a desativar silenciosamente. Alimenta o resultado directamente num componente de calendário, ou usa as contagens para decidir se a janela precisa de ser alargada antes de voltares a perguntar.

Ambos os registos provêm da tradição do almanaque impresso e não de uma classificação inventada, e o endpoint nunca inventa um dia: um resultado vazio continua vazio e indica qual registo o esvaziou. O limite diário é às 23:00, consistente com todos os outros endpoints chineses aqui. Os nomes das atividades seguem a lista própria do registo, por isso uma atividade desconhecida é recusada com um 400 que indica o campo.