Lunaple API

토정비결·작명 결정론 계산 API. AI 해석을 넣지 않습니다 — 계산 결과와 출처만 돌려주고, 해석은 호출하는 쪽 LLM에 맡기도록 설계했습니다.

서울 리전~0.3s출처 명시한글 독음 병기

샌드박스 키 받기 무료 · 월 300회

키는 발급 직후 한 번만 표시됩니다. 분실 시 같은 이메일로 다시 요청하면 기존 키가 폐기되고 새 키가 나옵니다.

바로 써보기

curl -X POST https://api.lunaple.kr/v1/tojeong/gwae \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"birth":"1988-05-14","targetYear":2026}'

{ "data": { "calc": { "gwaeId": "751", "yearGapja": "丙午", ... },
  "gwae": { "title": { "hanja": "奔走奔忙無所得之意", "reading": "분주분망무소득지의" },
            "yearly": [ "삼일지정(三日之程) 일일행지(一日行之)", ... ], "monthly": { "1": [...], ... } },
  "source": { "text": "토정비결 144괘 — 웹 공개본 2종 대조 ...", "calc": "lunar-javascript 1.7.7" } } }

왜 "계산만" 하나요

운세 서비스에서 틀리면 안 되는 건 숫자입니다 — 괘 번호, 간지, 획수, 수리. 이 API는 그 결정론 부분만 맡습니다. 해석 문장은 호출하는 쪽에서 원하는 LLM·톤·언어로 만드세요. 그래서 응답마다 source(출처·계산기)가 붙고, 같은 입력은 언제나 같은 출력입니다.

작괘 1,116건 전수 + 윤달·소월·설날 경계 검증, 144괘 6,480구절 독음 전수 병기(다음자 45자·구절 70종 수작업 확정). 샘플 코드 →

엔드포인트

메서드	경로	설명
POST	`/v1/tojeong/gwae`	생년월일(양/음력·윤달) + 대상연도 → 작괘·144괘 원문·독음
GET	`/v1/tojeong/gwae/{id}`	괘ID 직접 조회 (캐시 가능)
POST	`/v1/name/analyze`	성·이름 한자 → 81수리·음양·발음오행·오격·점수
GET	`/v1/name/char/{hanja}`	인명용 한자 1자 조회 (독음·획수·뜻)
POST	`/v1/keys/request`	샌드박스 키 발급 (이메일당 1키)

인증: X-API-Key 헤더. 오류는 { error: { code, message } }. 전체 스키마: openapi.yaml

요금

플랜	월	호출	분당
Sandbox	무료	300	10
Starter	₩39,000	1,000	60
Growth	₩99,000	4,000	120
작명 B2B	연 계약 · support@yujinnetwork.com

유료 플랜 결제는 준비 중입니다. 지금은 이메일로 요청 주시면 수동 전환해 드립니다.

유진네트워크 · 사업자등록 202-08-74346 · 데이터 출처는 모든 응답의 source 필드에 명시됩니다.