만세력 API — 사주 계산 무료 API

지금 바로 눌러보기

브라우저 주소창에 그대로 넣어도 됩니다.

직접 넣어보기

요청

GET https://jeombom.kr/api/manse

태어난 시각을 모르시면 hour 를 빼세요. 임의로 자정이나 정오를 넣으면 틀린 시주가 결과에 섞입니다. 빼면 시주 없이 여섯 글자로 계산하고, 응답의 pillars.hour 가 null 로 옵니다.

응답

1958년 6월 1일 00시 30분 예시입니다. 서머타임과 과거 표준시가 동시에 걸리는 날입니다.

{
  "ok": true,
  "input": {
    "year": 1958,
    "month": 6,
    "day": 1,
    "hour": 0,
    "minute": 30,
    "hasTime": true,
    "calendar": "solar",
    "gender": "male",
    "trueSolarTime": true
  },
  "correction": {
    "applied": true,
    "standardMeridian": "동경 127.5도",
    "utcOffset": "UTC+08:30",
    "daylightSaving": true,
    "note": "이 날짜는 과거 표준시 또는 서머타임 구간입니다. 보정하지 않으면 시주가 한 칸 어긋날 수 있습니다.",
    "reference": "https://jeombom.kr/pyojunsi"
  },
  "pillars": {
    "year": [
      "무",
      "술"
    ],
    "month": [
      "정",
      "사"
    ],
    "day": [
      "무",
      "신"
    ],
    "hour": [
      "임",
      "자"
    ]
  },
  "dayMaster": {
    "stem": "무",
    "element": "토",
    "name": "무토(戊土)",
    "image": "넓고 단단한 큰 산"
  },
  "ilju": {
    "name": "무신",
    "url": "https://jeombom.kr/ilju/musin"
  },
  "elements": {
    "목": 1,
    "화": 3,
    "토": 3,
    "금": 2,
    "수": 1
  },
  "strength": "신강",
  "yongsin": "목",
  "voids": [
    "인",
    "묘"
  ],
  "meta": {
    "engine": "점봄 만세력 (한국천문연구원 KASI 절기 데이터 기준)",
    "license": "CC BY 4.0",
    "attribution": "계산: 점봄 만세력 API (https://jeombom.kr)"
  }
}

주요 필드

코드로 부르기

curl

curl "https://jeombom.kr/api/manse?year=1990&month=5&day=15&hour=14&minute=30"

JavaScript

const p = new URLSearchParams({ year: 1990, month: 5, day: 15, hour: 14, minute: 30 });
const r = await fetch(`https://jeombom.kr/api/manse?${p}`);
const saju = await r.json();
console.log(saju.pillars.day);        // ['경', '진']
console.log(saju.correction.utcOffset); // 'UTC+09:00'

Python

import requests

r = requests.get("https://jeombom.kr/api/manse",
                 params={"year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30})
saju = r.json()
print(saju["pillars"]["day"])   # ['경', '진']
print(saju["yongsin"])          # '목'

다른 만세력과 결과가 다를 수 있습니다

같은 생년월일시인데 만세력마다 시주가 다르게 나오는 일이 흔합니다. 이 API 는 아래 세 가지를 모두 반영하고, 무엇을 반영했는지 응답에 적어 보냅니다.

두 번째와 세 번째가 겹치는 1955~1960년 여름에는 차이가 최대 1시간 30분까지 벌어집니다. 시주는 두 시간 단위라 이 정도면 글자가 확실히 바뀌고, 자정 무렵이면 일주까지 달라집니다.

근거 자료는 한국 표준시 자료에 날짜 단위로 공개해 두었습니다. 기계가 읽는 원본은 /data/korea-standard-time.json 입니다.

이 API 는 점봄 웹서비스와 같은 코드로 계산합니다. 앱에서 본 결과와 API 결과가 어긋나지 않습니다.

쓰는 조건

무료입니다. 상업적 이용도 됩니다. 라이선스는 CC BY 4.0 이고, 조건은 하나 — 출처를 밝혀 주세요.

오류를 발견하시거나 필요한 필드가 있으면 contact@x-on.kr 로 알려 주세요. 실제로 고치고 회신드립니다.

오류 응답

실패하면 ok: false 와 함께 이유를 돌려줍니다.

자주 묻는 질문

API 키가 필요한가요?

필요 없습니다. 가입도 인증도 없이 주소만 호출하시면 됩니다. CORS 도 열려 있어 브라우저에서 바로 부르실 수 있습니다.

상업적으로 써도 되나요?

됩니다. CC BY 4.0 이라 출처만 밝히시면 상업적 이용을 포함해 자유롭게 쓰실 수 있습니다. "사주 계산: 점봄 만세력 API (https://jeombom.kr)" 정도면 충분합니다.

태어난 시각을 모르면 어떻게 하나요?

hour 파라미터를 빼세요. 시주를 세우지 않고 연주·월주·일주 여섯 글자로 계산합니다. 임의로 0시나 12시를 넣으면 틀린 시주가 결과에 섞이므로 권하지 않습니다.

왜 다른 만세력과 결과가 다른가요?

진태양시(약 32분), 과거 표준시(1954~1961년 UTC+8:30), 서머타임(12구간)을 모두 보정하기 때문입니다. 이 셋 중 하나라도 빠뜨리면 시주가 한 칸 어긋납니다. 응답의 correction 필드에서 무엇이 적용됐는지 확인하실 수 있습니다.

입력한 생년월일이 저장되나요?

저장하지 않습니다. 계산에만 쓰고 바로 버리며 로그도 남기지 않습니다.

사용량 제한이 있나요?

별도 제한을 두지 않았습니다. 같은 생일은 결과가 늘 같아 CDN 이 대신 답하기 때문에 부담이 크지 않습니다. 대량 사용을 계획하신다면 contact@x-on.kr 로 미리 알려 주시면 좋습니다.

함께 보기