Natal Chart API
서양 점성술 출생 차트를 계산하는 API입니다. 천체 위치, 하우스, 앵글, 애스펙트 등 완전한 차트 정보를 제공합니다.
출생 차트 계산
POST
/v1/astrology/natal-chart인증 필요출생 정보를 기반으로 완전한 네이탈 차트를 계산합니다.
요청 파라미터
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
datetime | string | 필수 | 출생 날짜 및 시간 (ISO 8601 형식) 예시: |
location | object | 필수 | 출생 위치 정보 |
location.latitude | number | 필수 | 위도 (-90 ~ 90) 예시: |
location.longitude | number | 필수 | 경도 (-180 ~ 180) 예시: |
location.elevation | number | 선택 | 고도 (미터) 예시: 기본값: |
location.timezone | string | 선택 | IANA 타임존 (예: Asia/Seoul) 예시: 기본값: |
house_system | string | 선택 | 하우스 시스템 (PLACIDUS, KOCH, WHOLE_SIGN 등) 예시: 기본값: |
name | string | 선택 | 차트 이름 예시: 기본값: |
include_asteroids | boolean | 선택 | 소행성 포함 여부 예시: 기본값: |
요청 예제
curl -X POST https://api.destinyapi.com/v1/astrology/natal-chart \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"datetime": "1990-01-15T14:30:00",
"location": {
"latitude": 37.5665,
"longitude": 126.978,
"timezone": "Asia/Seoul",
"elevation": 38
},
"house_system": "PLACIDUS",
"name": "John Doe",
"include_asteroids": false
}'하우스 시스템
지원되는 하우스 시스템:
| 시스템 | 설명 |
|---|---|
PLACIDUS | 가장 널리 사용되는 시간 기반 시스템 (기본값) |
KOCH | Koch 하우스 시스템 |
WHOLE_SIGN | 고대 점성술에서 사용하는 전체 사인 시스템 |
EQUAL | 상승점부터 30도씩 균등 분할 |
CAMPANUS | Campanus 시스템 |
REGIOMONTANUS | Regiomontanus 시스템 |
성공 응답
200 OK - 차트 계산 성공
응답 상태:200
응답 구조
chart_info: 차트 메타데이터 (이름, 날짜, 시간, 위치, 하우스 시스템)angles: 주요 앵글 정보 (객체의 키는 소문자 ID)asc(Ascendant),mc(Midheaven),dsc(Descendant),ic(Imum Coeli)- 각 앵글의 경도(longitude), 별자리(sign), DMS 형식(dms) 포함
bodies: 각 천체의 위치, 별자리, 하우스, 역행 여부 (객체의 키는 소문자 ID)- 지원 천체:
sun,moon,mercury,venus,mars,jupiter,saturn,uranus,neptune,pluto - 소행성 (옵션):
chiron,north_node,south_node - 각 천체는 경도(longitude), 위도(latitude), 거리(distance), 별자리(sign), 하우스(house), 역행 여부(retrograde), DMS 형식(dms), 속도(speed) 포함
- 지원 천체:
houses: 12하우스 정보 (house_1~house_12)- 각 하우스의 커스프 경도(cusp_longitude), 별자리(sign), 하우스 내 천체 목록(bodies)
- bodies 배열의 요소는 천체 ID (소문자, 예:
["sun", "mercury"])
aspects: 천체 간 주요 애스펙트 (Conjunction, Sextile, Square, Trine, Opposition)body1,body2: 애스펙트를 형성하는 두 천체 (소문자 ID, 예: "sun", "moon")aspect_type: 애스펙트 종류orb: 정확한 각도와의 차이exact: 정확한 애스펙트 여부applying: 애스펙트가 형성 중인지 분리 중인지
dignities: 각 천체의 에센셜 디그니티 정보 (옵션, 키는 소문자 ID)essential_dignities: 디그니티 목록 (Domicile, Exaltation 등)is_peregrine: Peregrine 상태 여부lilly_score: William Lilly의 디그니티 점수
에러 응답
400 Bad Request - 잘못된 날짜 형식
응답 상태:400
{
"success": false,
"error": {
"code": "INVALID_DATETIME",
"message": "Invalid datetime format. Use ISO format: YYYY-MM-DDTHH:MM:SS"
}
}400 Bad Request - 잘못된 위치 정보
응답 상태:400
{
"success": false,
"error": {
"code": "INVALID_LOCATION",
"message": "Latitude must be between -90 and 90"
}
}데모 차트
GET
/v1/astrology/natal-chart/demo인증 필요API 테스트를 위한 샘플 출생 차트를 반환합니다. (1990년 1월 1일 12시, 서울)
요청 예제
curl -X GET https://api.destinyapi.com/v1/astrology/natal-chart/demo \
-H "X-API-Key: your_api_key_here"데모 엔드포인트는 파라미터 없이 고정된 샘플 차트를 반환하므로, API를 빠르게 테스트할 수 있습니다.
일반적인 에러
| 에러 코드 | 설명 | 해결 방법 |
|---|---|---|
INVALID_DATETIME | 날짜/시간 형식이 잘못됨 | ISO 8601 형식 (YYYY-MM-DDTHH:MM:SS) 사용 |
INVALID_LOCATION | 위치 정보 범위 초과 | 위도: -90~90, 경도: -180~180 확인 |
INVALID_HOUSE_SYSTEM | 지원하지 않는 하우스 시스템 | 지원되는 하우스 시스템 목록 참고 |
UNAUTHORIZED | API 키가 유효하지 않음 | API 키 확인 및 재발급 |
RATE_LIMIT_EXCEEDED | 요청 제한 초과 | 요청 제한 리셋 시간 대기 또는 플랜 업그레이드 |