API di selezione data Tong Shu

Ogni giorno nella finestra viene risolto nel suo pilastro giornaliero dal ciclo sessagesimale, poi letto attraverso due registri indipendenti. I dodici ufficiali giornalieri 建除十二值星 ciclano con il ramo mensile e ognuno porta la propria lista di ciò che si adatta e ciò che vieta: adattamenti completi per firmare e celebrare, adattamenti stretti quasi nulla. Le ventotto mansioni lunari ciclano su un ritmo di sette giorni indipendentemente dagli ufficiali, e portano le proprie approvazioni. Un giorno viene approvato solo quando l'attività scelta sopravvive a entrambi i registri. Il filtro opzionale di conflitto rimuove quindi i giorni il cui ramo è opposto all'animale che nomini, che è come la tradizione esclude la persona per cui il giorno viene scelto. La risposta segnala scansionati, corrispondenti e la suddivisione di cosa è stato scartato per registro e per conflitto, così una risposta vuota è comprensibile piuttosto che 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"
      }
    ]
  }
}

Usalo nei flussi di prenotazione, pianificazione eventi, prodotti per matrimoni e location, pianificazione clinica, o ovunque un selettore di date dovrebbe preferire silenziosamente alcuni giorni ad altri. Poiché restituisce la motivazione e non solo il verdetto, puoi mostrare a un utente perché il terzo martedì è mancante invece di renderlo grigio in modo silenzioso. Inserisci direttamente il risultato in un componente calendario, o usa i conteggi per decidere se la finestra ha bisogno di essere allargata prima di richiedere di nuovo.

Entrambi i registri provengono dalla tradizione dell'almanac stampato piuttosto che da una classifica inventata, e l'endpoint non inventa mai un giorno: un risultato vuoto rimane vuoto e segnala quale registro lo ha svuotato. Il limite del giorno è 23:00, coerente con ogni altro endpoint cinese qui. I nomi delle attività seguono la lista del registro stesso, quindi un'attività sconosciuta viene rifiutata con un 400 che nomina il campo.