만세력 API를
서비스 매출 구조
에 맞게 연결합니다.
생년월일, 성별, 출생지, 달력 구분을 입력하면 서비스에서 바로 쓸 수 있는
만세력·사주 분석 데이터를 JSON API로 제공합니다. 작명 API와 향후 점성술 API 확장까지 같은 구조로 설계합니다.
Trusted by Industry Leaders
상용 서비스에서 먼저 검증된 Manse-force Engine
핵심 만세력·신살·궁합 로직은 쎄하다 실서비스와 고객 서비스에서 운영하고 있습니다. 200+는 월 구독을 이용 중인 유료 고객 수이며, 테스트 키 이용자는 포함하지 않습니다. UptimeRobot 모니터링 대상은 2025년 12월 출시 이후 측정 기간 내 무중단 운영을 기록했습니다. 치명 오류 0건은 해당 기간의 내부 운영 기록 기준입니다. 가용성, 지원 시간과 장애 대응 범위는 계약별 SLA로 정합니다.
운세 앱, 콘텐츠 플랫폼, 브랜드 캠페인에 API 형태로 연동됩니다.
UptimeRobot 모니터링 대상은 2025년 12월 출시 이후 측정 기간 내 무중단 운영을 기록했습니다.
치명 오류 0건은 해당 기간의 내부 운영 기록 기준입니다.
쎄하다 실서비스에서 무료 만세력, 신살, 궁합, 리포트 상품의 결과 품질을 확인할 수 있습니다.
만세력 API 도입 전 확인해야 할 기준
단순 풀이 문구가 아니라 인증, 응답 구조, 운영 지표까지 서비스에 붙일 수 있어야 합니다.
1 명확한 API 계약
Contract입력값, 응답 필드, 오류 코드, 인증 헤더를 분리해 프론트엔드와 백엔드가 동시에 붙을 수 있는 구조로 설계합니다.
2 운세 도메인 로직
Domain만세력, 사주 분석, 작명, 궁합처럼 서비스마다 필요한 해석 단위를 API 모듈로 나누어 적용합니다.
3 운영과 과금 대응
OpsAPI 키 발급, 사용량 측정, 월별 요청량, 요금제 분리, 운영 모니터링까지 API 사업화에 필요한 기준을 함께 봅니다.
API Platform 확장 구조
지금은 만세력 API를 중심으로 시작하고, 같은 인증·과금·문서 체계에서 작명 API와 점성술 API까지 확장할 수 있습니다.
Manse-force API
생년월일, 성별, 출생지, 달력 구분을 기준으로 만세력과 사주 분석 데이터를 반환하는 핵심 API입니다. Core는 계산 데이터만, 전문 만세력+SIS는 Core 전체와 전문 분석·신살 54종을 제공합니다. 두 상품은 같은 엔드포인트에서 API 키 권한으로 구분됩니다.
- ✓ 생년월일, 성별, 출생지, 달력 구분 입력 지원
- ✓ 사주 팔자, 오행, 요약, 상세 필드 응답 구성
- ✓ 운세 앱, 멤버십 서비스, 이벤트 랜딩에 적용 가능
Naming API
성씨, 한자, 오행 균형, 발음 조건을 기준으로 작명 후보와 해석 데이터를 제공하는 확장 모듈입니다. 내부 테스트 중 · 승인형 PoC 문의
- ✓ 성씨, 성별, 출생 정보를 기준으로 후보 생성
- ✓ 이름 후보, 점수, 해석 근거를 응답 구조로 제공
- ✓ 작명 서비스, 상담 예약, 리드 수집에 적용 가능
Astrology API Ready
점성술 API는 내부 테스트 중이며 승인형 PoC로 문의할 수 있습니다. 정식 요금은 아직 확정되지 않았고, 일반 호출용 공개 API로 제공하지 않습니다.
- ✓ 별자리·행성 위치·트랜짓 모듈 검토
- ✓ 점성술 API 문서 구조는 정식 공개 전 단계
- ✓ 글로벌 운세 앱과 데일리 콘텐츠 확장 가능
Custom API Bundle
기존 서비스에 맞춰 필요한 API만 묶고, 관리자·사용량·요금제·결제 흐름까지 함께 붙이는 구축형 옵션입니다.
- ✓ API 키, 사용 한도, 거래 로그 관리 구조 포함
- ✓ 모니터링과 단계적 배포 흐름까지 함께 설계
- ✓ B2B 제휴, 자체 앱, 캠페인에 맞춰 구성 가능
Fortune API Platform
필요한 결과의 깊이에 맞춰 선택하세요
| 구분 | 제공 결과 | 응답 방식 |
|---|---|---|
| 콘텐츠·리텐션 | 짧은 문구·점수·키워드 | 즉시 응답 |
| 만세력 Core | 원국·오행·십성·십이운성·대운 | 즉시 응답 |
| 전문 만세력+SIS | Core + 강약·격국·용신·관계·공망·신살 54종 | 즉시 응답 |
| 표준 해설 | 검수형 고정 문구 · 내부 테스트 | 즉시 응답 / 승인 범위 |
| 맞춤 해설 | 계산 결과 기반 장문 해설 | Callback |
두 상품은 기존 GET /api/v2/saju/fortune 엔드포인트를 공유하며 API 키 권한으로 제공 범위를 구분합니다. 아래 통합 필드·응답 예시는 해당 권한이 승인된 경우의 구조이며 Core에 모든 전문 필드가 포함된다는 뜻은 아닙니다. SIS 상대강도는 통계 확률이 아닌 내부 지수입니다.
Fortune API Platform
상품별 제공 상태
| 구분 | 상품별 제공 상태 |
|---|---|
| 만세력 Lite | 정식 제공 |
| 오늘운세·띠별운세 | 정식 제공 |
| 만세력 Core·전문 만세력+SIS | 정식 제공 |
| 별자리운세·바이오리듬 | 내부 테스트 중 · 승인형 PoC 문의 |
| 표준 해설 | 내부 테스트 중 · 승인형 PoC 문의 |
| 토정비결·택일·작명 | 내부 테스트 중 · 승인형 PoC 문의 |
한국·일본 정식 제공 · 중국·대만 PoC · 미국·영국·유럽 파트너 협의. 실제 제공 제품·언어는 승인 및 계약 범위에 따라 확정합니다. 일일 별자리운세와 전문 점성술은 별도 상품입니다.
콘텐츠·리텐션
홈 피드·푸시·위젯에 활용하는 만세력 Lite·오늘운세·띠별운세. 별자리운세와 바이오리듬은 내부 테스트 중입니다.
PAYG 90P/건 · 월정액 99,000원부터
전문 만세력·SIS
만세력 Core는 계산 데이터만, 전문 만세력+SIS는 Core 전체와 전문 분석·신살 54종 상세 데이터를 제공합니다.
Core 월 149,000원부터 · 전문+SIS 월 249,000원부터
해설·전문 결과
기존 맞춤 해설은 Callback으로 제공합니다. 표준 해설·토정비결·택일·작명은 내부 테스트 중이며 승인형 PoC로 문의할 수 있습니다.
상품별 완성 결과 단가 · 테스트 상품은 승인 후 제공
신규 신청에 적용되는 Fortune API 표준 요금입니다. 모든 금액은 한국어 표준 응답 기준 KRW 공급가액이며 VAT 별도입니다. 기존 고객은 기존 계약 조건을 따릅니다.
글로벌 파트너 운영에서 검증된 API 안정성
강한 로직은 내부에 보호하고, 외부에는 실제 운영 지표와 연동 기준으로 신뢰를 증명합니다.
위 운영 수치는 내부 운영 기록 기준입니다. SLA, 모니터링, 장애 대응 범위는 계약 조건과 트래픽 규모에 맞춰 별도 합의합니다.
오프라인 이벤트형 운세 경험
브랜드 팝업, 키오스크, 영수증 출력처럼 짧은 체류 시간 안에 결과를 보여줘야 하는 캠페인형 운세 경험을 설계했습니다. 사례에서 확인할 수 있는 구현 범위는 팝업 현장의 운세 체험 화면, 사진 촬영과 결과 표시, 영수증 출력 연동입니다.
📸 안면인식 & 영수증 출력
사용자가 사진을 찍으면 즉석에서 운세가 인쇄됩니다.
프리미엄 사주 앱 '쎄하다'
Ablecity의 핵심 만세력·신살·궁합 로직이 적용된 실서비스입니다. API 도입 전 쎄하다의 무료 만세력과 주요 리포트를 통해 결과 품질, 상품 전환 구조, 콘텐츠 확장 방식을 직접 확인할 수 있습니다. 직접 확인: 쎄하다의 무료 만세력과 주요 리포트 화면에서 계산 데이터의 표현 방식과 결과·결제 동선을 살펴볼 수 있습니다.
- 무료 만세력, 신살, 궁합, 타이밍 리포트로 이어지는 상용 검증 구조
- 구독형·단건 결제형 상품 설계에 맞춘 결과 데이터 구성
- 내부 로직을 공개하지 않고도 결과 품질을 체험할 수 있는 테스트 채널
필요한 API만 단계적으로 도입하세요.
만세력 API로 시작한 뒤 작명 API, 점성술 API, 전용 관리자까지 단계적으로 확장할 수 있습니다.
구독형 API와 구축형 프로젝트를 서비스 규모에 맞춰 선택합니다.
이미 API 키를 받은 고객은 API Dashboard에서 회원가입 후 사용량, 구독, API 조회를 확인할 수 있습니다.
30일 승인형 Sandbox → PAYG 운영 도입 → 월정액 구독 → Enterprise·Volume 협의
콘텐츠 100회 · Core/전문 만세력+SIS 합산 1,000회 · 표준 결과 20회 · Callback 완료 결과 5건. 승인된 제품·테스트 범위에 한해 제공하며 운영·상업 서비스에는 사용할 수 없습니다. 내부 테스트 상품은 별도 승인 범위를 확인합니다.
제출 후 영업일 기준 1일 이내 1차 검토 결과와 발급 범위를 이메일로 안내합니다. API 키는 승인된 제품과 사용 범위에 한해 별도 이메일로 발급합니다.
각 열은 별도 상품의 구독 가격입니다. 포함량은 콘텐츠·Core·전문 만세력+SIS별로 독립 집계하며 상품 간 공유·전환할 수 없습니다. 승인된 콘텐츠·리텐션 모듈끼리는 포함량을 공유합니다. 포인트 잔액은 하나로 공유합니다.
구독 포함량 초과 시 콘텐츠·Core는 90P/건, 전문 만세력+SIS는 150P/건으로 공통 포인트에서 자동 차감합니다. 잔액이 해당 요청의 필요 포인트보다 부족하면 초과 이용이 제한됩니다.
운영형 API 안정성
기업 연동에 필요한 인증, 사용량, 모니터링, SLA 옵션을 계약 범위에 맞춰 제공합니다.
SLA 옵션 제공
서비스 수준 협약(SLA)은 트래픽 규모와 운영 범위에 맞춰 계약형으로 제공합니다.
사용량 기반 운영
키별 요청량, 월별 사용량, 무료 구간, 초과 과금 기준을 서비스 정책에 맞춰 설계합니다.
전담 기술 지원
도입 초기 연동, 샘플 응답 검토, 운영 이슈 대응은 계약 범위에 맞춰 지원합니다.
자주 묻는 질문
/services/saju와 /api는 역할이 어떻게 다른가요? ▼
/services/saju는 API 도입 상담과 전환을 위한 랜딩 페이지이고, /api는 개발자가 파라미터와 응답 예시를 확인하는 문서 페이지입니다.
점성술 API도 같은 구조로 추가할 수 있나요? ▼
점성술 API는 내부 테스트 중이며 승인형 PoC로 문의할 수 있습니다. 정식 요금은 아직 확정되지 않았고, 일반 호출용 공개 API로 제공하지 않습니다.
API 키만 받아서 바로 테스트할 수 있나요? ▼
제출 후 영업일 기준 1일 이내 1차 검토 결과와 발급 범위를 이메일로 안내합니다. API 키는 승인된 제품과 사용 범위에 한해 별도 이메일로 발급합니다.
API Dashboard는 언제 사용하나요? ▼
API 키를 받은 뒤 API Dashboard에서 회원가입하면 사용량, 구독 상태, API 조회를 확인할 수 있습니다. 키 발급 전 신규 상담은 API 키 신청 또는 도입 상담을 먼저 진행해 주세요.
기존 앱이나 웹서비스에도 붙일 수 있나요? ▼
가능합니다. 기존 회원, 결제, 결과 페이지 구조를 먼저 확인한 뒤 API 응답을 어디에 연결할지 설계합니다.
Core와 전문 만세력+SIS는 어떻게 구분하나요?▼
만세력 Core는 원국·오행·십성·십이운성·대운 등 계산 데이터만 반환합니다. 전문 만세력+SIS는 Core 전체에 강약·격국·용신·지지 관계·공망과 신살 54종의 위치·상태·영향도 데이터를 더합니다. 두 상품은 기존 GET /api/v2/saju/fortune 엔드포인트를 공유하며 API 키 권한으로 제공 범위를 구분합니다. 아래 통합 필드·응답 예시는 해당 권한이 승인된 경우의 구조이며 Core에 모든 전문 필드가 포함된다는 뜻은 아닙니다. SIS 상대강도는 통계 확률이 아닌 내부 지수입니다.
내부 테스트 상품도 바로 호출할 수 있나요?▼
내부 테스트 상품은 승인형 PoC 문의 대상입니다. 문서의 예정 경로는 변경 가능하며 일반 호출은 불가합니다. 실제 이용 경로와 한도는 승인 후 안내합니다.
요금과 구독은 어떻게 적용되나요?▼
각 열은 별도 상품의 구독 가격입니다. 포함량은 콘텐츠·Core·전문 만세력+SIS별로 독립 집계하며 상품 간 공유·전환할 수 없습니다. 승인된 콘텐츠·리텐션 모듈끼리는 포함량을 공유합니다. 포인트 잔액은 하나로 공유합니다. 구독 포함량 초과 시 콘텐츠·Core는 90P/건, 전문 만세력+SIS는 150P/건으로 공통 포인트에서 자동 차감합니다. 잔액이 해당 요청의 필요 포인트보다 부족하면 초과 이용이 제한됩니다.
만세력 API 도입 상담
API 키 발급, 기존 서비스 연동, 점성술 API 확장 계획까지
한 번에 검토할 수 있습니다.
계약 전 기능 범위, 납품물, 검수 기준, 변경 요청의 비용·일정 영향, 소스·문서 이관, 유지보수와 SLA 범위를 확인합니다.