중국 십이지 궁합 API

각 날짜는 태양년으로 환산되는데, 이 해는 1월 1일이나 음력설이 아니라 역천(曆典)에서 가져온 입춘 순간에 시작된다. 그 해가 지지(地支)와 해당 동물을 결정한다. 점수는 두 지지 사이의 관계를 읽는다: 원 위에 균등하게 배치된 세 지지씩 네 그룹으로 묶이는 삼합(三合)과, 각 지지를 정반대 지지와 짝짓는 육충(六冲)이다. 인접하거나 중립적인 관계는 그 사이에 위치한다. 응답은 두 동물, 숫자 점수, 카테고리, 그리고 그 조합이 의미하는 바를 설명하는 짧은 노트를 반환하므로, UI가 별도의 조회 표 없이 결과를 보여줄 수 있다.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "person1": { "date": "1990-05-15" },
    "person2": { "date": "1988-02-20" }
  }'

{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}

날짜 하나만으로 빠르고 저렴한 궁합 신호가 필요할 때 사용하면 된다: 매칭 필터, 공유 가능한 카드, 퀴즈, 마케팅 위젯, 출생 시각을 물었다가는 전환율을 잃을 온보딩 단계 등. 카탈로그에서 가장 거친 리딩이며 그 사실을 숨기지 않는다. 연도 동물은 사람의 여덟 글자 중 정확히 하나만 알기 때문이다. 제품에 진짜 리딩이 필요하다면 두 사람의 전체 사주(八字) 차트를 뽑아 네 기둥 전체의 상호작용을 살펴보는 게 낫다.

점수는 손으로 쓴 의견 행렬이 아니라 삼합(三合)과 육충(六冲)의 정전(正典) 교리에서 도출되므로 재현 가능하고 스스로를 설명한다. 입춘 하루 안팎의 출생은 시각이 중요한 유일한 경우다: time과 timezoneOffset을 넘기면 경계가 초 단위로 결정된다. 동물 이름은 21개 언어로 번역되며 영어 token은 그대로 유지된다.