공개 API

만세력 API

생년월일시를 주면 사주팔자 네 기둥과 십신, 오행 개수, 대운을 JSON 으로 돌려줍니다. 키가 필요 없습니다. 가입도, 발급도, 심사도 없습니다. 아래 명령을 그대로 붙여 넣으면 답이 옵니다.

절기 경계, 음력·양력 변환, 야자시 처리가 계산에 들어 있습니다. 직접 구현하면 가장 오래 걸리는 세 가지입니다.

요청

curl -X POST https://api.sortia-ai.com/v1/tools/manseryeok \
  -H 'Content-Type: application/json' \
  -d '{
    "birth_date": "1990-03-15",
    "birth_time": "14:30",
    "calendar": "solar",
    "gender": "female"
  }'
  • birth_date필수. YYYY-MM-DD
  • gender필수. male | female — 원국은 같고 대운 방향이 갈립니다
  • birth_time선택. HH:MM. 없으면 시주를 비웁니다
  • calendar선택. solar(기본) | lunar
  • lunar_leap_month선택. 음력 윤달이면 true

응답

{
  "pillars": {
    "year":  { "name": "경오", "hanja": "庚午",
               "stem_sipsin": "상관", "branch_sipsin": "편인" },
    "month": { "name": "기묘", "hanja": "己卯",
               "stem_sipsin": "비견", "branch_sipsin": "편관" },
    "day":   { "name": "기묘", "hanja": "己卯",
               "stem_sipsin": "일간", "branch_sipsin": "편관" },
    "hour":  { "name": "신미", "hanja": "辛未",
               "stem_sipsin": "식신", "branch_sipsin": "비견" }
  },
  "element_counts": { "목": 2, "화": 1, "토": 3, "금": 2, "수": 0 },
  "daeun": [
    { "age": 3,  "name": "무인" },
    { "age": 13, "name": "정축" },
    { "age": 23, "name": "병자" }
  ],
  "element_rarity": { "share": 0.0142, "one_in": 70, "sample_size": 197232 }
}

element_rarity 는 같은 오행 배치가 얼마나 흔한지입니다. 197,232건을 세어 만든 분포에서 찾은 값이고, 센 적 없는 배치면 null 이 옵니다. 없는 숫자를 만들어 넣지 않습니다.

호출 한도

IP 하나당 60초에 10회입니다. 넘으면 429 와 함께 Retry-After 초가 옵니다. 브라우저에서 바로 불러도 됩니다 — 모든 도메인에 열려 있습니다.

더 많이 필요하시면 말씀해 주세요. 무엇을 만드시는지 들으면 한도를 올려 드립니다.

쓰는 조건

상업적 사용을 포함해 자유롭게 쓰셔도 됩니다. 한 가지만 부탁드립니다 — 출처를 남겨 주세요. 이 한 줄이면 됩니다.

<a href="https://sortia-ai.com">만세력 계산: SORTIA</a>

계산 결과는 명리 규칙을 그대로 적용한 값입니다. 규칙에 이견이 있는 지점(야자시, 조자시, 절기 경계)은 저희 선택이 들어가 있으니, 다르게 보시면 알려 주세요.

같이 열어 둔 것

  • GET https://api.sortia-ai.com/v1/public/today-iljin오늘의 간지. 입력이 없습니다
  • GET https://api.sortia-ai.com/v1/public/element-statistics오행 분포 집계 원본 (설명)