통서 날짜 선택 API

기간 안의 모든 날짜는 육십갑자에서 일주(日柱)로 변환된 뒤, 서로 독립적인 두 가지 체계로 해석돼. 십이건제(建除十二值星)는 월지(月支)를 따라 순환하며 각각 무엇에 적합하고 무엇을 금하는지 자체 목록을 가지고 있어: 만(滿)은 계약과 경사에 좋고, 폐(閉)는 거의 아무것에도 맞지 않아. 이십팔수(二十八宿)는 건제와 무관하게 7일 주기로 순환하며 자체적인 길흉 판단을 가지고 있어. 선택한 활동이 두 체계 모두를 통과해야만 그 날이 살아남아. 선택적인 충(沖) 필터는 네가 지정한 동물과 지지가 정반대인 날을 제거하는데, 이것이 바로 전통에서 그 날을 고르는 당사자를 배제하는 방식이야. 응답에는 스캔한 수, 일치한 수, 그리고 체계별·충별 탈락 내역이 포함돼서, 빈 결과도 왜 비었는지 알 수 있어.

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

예약 플로우, 이벤트 기획, 결혼식·장소 상품, 병원 스케줄링 등 날짜 선택기가 어떤 날을 조용히 우선해야 하는 곳이라면 어디든 써봐. 판정만이 아니라 근거까지 돌려주기 때문에, 셋째 주 화요일이 왜 빠졌는지 사용자에게 보여줄 수 있어. 그냥 회색 처리만 하는 게 아니라 말이야. 결과를 캘린더 컴포넌트에 바로 넣어도 되고, 카운트를 보고 다시 물어보기 전에 기간을 넓혀야 할지 판단해도 돼.

두 체계 모두 임의로 만든 순위가 아니라 인쇄 역법 전통에서 온 것이고, 이 endpoint는 절대 날짜를 지어내지 않아: 빈 결과는 빈 채로 남고 어느 체계가 비웠는지 알려줘. 하루의 경계는 23:00이며, 여기 있는 다른 모든 중국식 endpoint와 일치해. 활동 이름은 해당 체계의 자체 목록을 따르기 때문에, 알 수 없는 활동은 어떤 필드가 문제인지 명시한 400으로 거부돼.