역학 정보 API

weirdreports.com 역학 정보 API는 양력/음력 변환, 한자·한글 간지, 24절기 정보를 JSON으로 제공합니다. 플러스(2등급) 이상 회원이 API 키를 발급받아 이용합니다. 비회원·준회원(1등급)은 이용할 수 없습니다.

---

목차

1. 이용 자격·인증 2. 기본 정보 3. 요청 파라미터 4. 응답 개요 5. 사용 한도 6. 사용 예시 7. 에러 코드 8. 관련 링크

---

이용 자격·인증

항목	내용
자격	회원 mb_level ≥ 2 (플러스 이상)
키 신청	/pro/api/apply/
키 관리·사용량	/pro/api/keys/
Header	X-API-Key: wr_live_… 또는 Authorization: Bearer wr_live_…

키는 서버 사이드에서만 사용하세요. 프론트엔드(JS)에 노출하지 않는 것을 권장합니다. 사용 도메인·서버 IP를 키에 등록하면 Origin / 접속 IP를 검사합니다.

---

기본 정보

URL

GET|POST https://weirdreports.com/pro/api/v2/calendar.php

• Content-Type: application/json; charset=utf-8
• 시간대: Asia/Seoul (KST)
• 지원 연도: 1900–2100
• 테스트: /pro/api/v2/
제공 정보:
• 양력 ↔ 음력 변환, 윤달
• 년·월·일·시 간지 (한자/한글, 천간·지지·오행)
• 현재/이전/다음 절기, (선택) 해당 연도 24절기 목록
• 요일, 한국식 나이·만나이

---

요청 파라미터

파라미터	필수	설명
year	예	연도 (1900–2100)
month	예	월 (1–12)
day	예	일
hour	아니오	시 (0–23, 기본 0)
minute	아니오	분 (0–59, 기본 0)
type	예	1 양력 입력, 2 음력 입력
leapmonth	아니오	0 평달, 1 윤달 (음력)
yearTerms	아니오	1이면 연간 24절기 포함 — 프로(4등급) 이상
include	아니오	반환 필드 선택 (예: ganzhi,solarTerm)

---

응답 개요

성공 시 success: true와 data에 solar / lunar / ganzhi / solarTerm / age 등이 포함됩니다. 간지는 기둥별 한자·한글·오행 구조와, 표시용 display 필드를 함께 제공합니다. 절기가 아닌 날에도 현재 절기 구간과 이전·다음 절기를 반환합니다. 검증 오류·권한·한도 초과는 HTTP 상태 코드와 code 필드로 구분합니다.

---

사용 한도

등급	초	분	시간	일	월
0·1 (게스트·준회원)	—	—	—	이용 불가	이용 불가
2 플러스	2	30	200	100	2,000
3 프리미엄	5	60	500	500	10,000
4 프로	10	120	1,000	1,000	20,000
5+ 마스터	20	300	3,000	5,000	100,000

한도 초과 시 HTTP 429 JSON 응답. 등급·요금 안내: /pro/intro/

---

사용 예시

curl -H "X-API-Key: wr_live_YOUR_KEY" \
  "https://weirdreports.com/pro/api/v2/calendar.php?year=2026&month=9&day=21&type=1"

fetch('https://weirdreports.com/pro/api/v2/calendar.php?year=2026&month=9&day=21&type=1', {
  headers: { 'X-API-Key': 'wr_live_YOUR_KEY' }
})
  .then(r => r.json())
  .then(data => {
    if (data.success) {
      console.log(data.data.solar, data.data.ganzhi, data.data.solarTerm);
    }
  });

---

에러 코드

코드	HTTP	설명
UNAUTHORIZED	401	API 키 없음
INVALID_API_KEY	401	키 무효
KEY_SUSPENDED	403	정지·폐기된 키
LEVEL_REQUIRED	403	2등급 미만
FORBIDDEN_ORIGIN	403	등록 사용처와 불일치
RATE_LIMIT_	429	초/분/시간/일/월 한도 초과
UPGRADE_REQUIRED	403	yearTerms는 4등급+
INVALID_	400	날짜·파라미터 오류

---

관련 링크

• 키 신청: https://weirdreports.com/pro/api/apply/
• 테스트: https://weirdreports.com/pro/api/v2/
• 등급 안내: https://weirdreports.com/pro/intro/
• 문의: https://weirdreports.com/pro/contact/

본 API는 별난보고서 표준만세력 엔진을 기반으로 합니다. 상업적 대량 이용은 help@weirdreports.com 으로 문의해 주세요. 최종 업데이트: 2026-09-24