생년월일과 출생시간으로 보는 사주팔자, 오행 균형, 십신, 대운 흐름을 REST API로 분석합니다. 한국어 사주 분석의 모든 것을 앱에 통합하세요.
3단계로 첫 사주 분석을 시작하세요.
관리자에게 API 키를 요청하거나, 대시보드에서 직접 발급받으세요.
아래 코드 예제를 복사해서 실행해보세요. 생년월일 정보를 전달하면 사주 분석 결과를 받습니다.
JSON 응답에 포함된 사주 풀이, AI 리포트, 캐릭터 이미지를 앱에 표시하세요.
curl -X POST https://fatemirror.ponslink.com/api/saju \
-H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{
"name": "홍길동",
"birth_date": "1992-03-01",
"birth_time": "06:30",
"birthplace": "서울",
"gender": "남성",
"calendar_type": "양력"
}'모든 API 호출에는 Authorization 헤더에 API 키를 포함해야 합니다.
Authorization: Bearer ***API 키는 sk_ 접두사로 시작하며, 관리자 대시보드에서 발급할 수 있습니다.
인증되지 않은 요청은 401 Unauthorized 응답을 반환합니다.
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 이름 또는 닉네임 |
birth_date | string | 예 | 생년월일 (YYYY-MM-DD) |
birth_time | string | 아니오 | 태어난 시각 (HH:MM). 모르면 빈 값 |
birthplace | string | 예 | 출생지 도시명 (서울, 부산, 도쿄 등) |
gender | string | 예 | "남성" 또는 "여성" |
calendar_type | string | 아니오 | "양력"(기본) 또는 "음력" |
timezone | string | 아니오 | IANA 시간대 (자동 감지됨) |
| 필드 | 설명 |
|---|---|
success | 분석 성공 여부 |
title | 사주 가이드 제목 (예: "🔮 홍길동님의 사주 가이드") |
sections | 사주 풀이 필드 목록 (배열) |
chart | 사주 차트 원시 데이터 (4주, 대운, 태양절 등) |
report | AI 생성 분석 리포트 (용신, 오행, 십신, 종합 평가) |
images | 캐릭터 이미지 (base64 data URL) |
id | 결과 고유 ID |
share | 공유 URL 정보 |
import requests
API_KEY = "***"
URL = "https://fatemirror.ponslink.com/api/saju"
response = requests.post(URL,
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
},
json={
"name": "홍길동",
"birth_date": "1992-03-01",
"birth_time": "06:30",
"birthplace": "서울",
"gender": "남성",
"calendar_type": "양력"
}
)
data = response.json()
print(f"제목: {data['title']}")
print(f"사주 풀이: {len(data['sections'])}개 섹션")
print(f"공유 링크: {data['share']['url']}")const API_KEY = "***";
const response = await fetch("https://fatemirror.ponslink.com/api/saju", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "홍길동",
birth_date: "1992-03-01",
birth_time: "06:30",
birthplace: "서울",
gender: "남성",
calendar_type: "양력"
})
});
const data = await response.json();
console.log("제목:", data.title);
console.log("사주 풀이:", data.sections.length, "개 섹션");curl -X POST https://fatemirror.ponslink.com/api/saju \
-H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{
"name": "홍길동",
"birth_date": "1992-03-01",
"birth_time": "06:30",
"birthplace": "서울",
"gender": "남성",
"calendar_type": "양력"
}' | python3 -m json.tool| 상태 코드 | 에러 | 설명 |
|---|---|---|
| 400 | Bad Request | 입력값 오류 (필수 필드 누락, 잘못된 날짜 형식 등) |
| 401 | Unauthorized | API 키가 없거나 무효합니다 |
| 429 | Too Many Requests | 레이트 리밋을 초과했습니다. retry_after_seconds 후 다시 시도하세요 |
| 500 | Internal Server Error | 서버 내부 오류. 지속되면 관리자에게 문의하세요 |
회원가입 후 대시보드에서 API 키를 발급받을 수 있습니다. 무료 플랜은 즉시 사용 가능합니다.
현재 양력만 지원합니다. 음력 변환 기능은 곧 추가될 예정입니다.
birth_time 필드를 비워두면 됩니다. 정확도가 떨어질 수 있지만, 기본 사주 분석은 가능합니다.
모든 분석 결과는 한국어로 제공됩니다. 섹션 제목, AI 리포트, 해석 모두 한국어입니다.
네, 각 요청은 독립적입니다. 동시 요청은 레이트 리밋 범위 내에서 가능합니다.
Pro 이상 플랜에서는 상업적 활용이 가능합니다. 자세한 내용은 이용약관을 참고하세요.