사주 API › 점성술 API
점성술 API
출생 일시와 좌표를 보내면 태양~명왕성 10개 천체, 달 교점, 4개 앵글, 하우스, 애스펙트, 품위를 계산하고, HRUM이 미리 써 둔 풀이 문단까지 한 번에 JSON으로 돌려줘요. 상품 이름은 「점성술 토탈」이고, LLM은 쓰지 않아요.
돌려주는 것
- 네이탈 차트 — 천체 위치·별자리·도수·하우스, 앵글, 애스펙트, 품위 (
natal) - 풀이 문단 — 품위·애스펙트에 미리 써 둔 문단, 추가 요금 없이 항상 함께 (
readings) - 트랜싯·2차 진행 — 요청에
timing을 붙였을 때 (timing) - 시너스트리 — 요청에
partner를 붙였을 때 두 사람 사이의 각과 별자리 관계 (synastry)
직접 골라야 하는 값
하우스 체계는 기본이 플라시두스이고 houseSystems로 바꿀 수 있어요. 트랜싯·진행 오브(timing.orbDegrees)는 원전끼리 값이 달라 기본값이 없어서, timing을 보내면 꼭 넣어야 해요. 비우면 400이에요.
제공하지 않는 것
마이너 품위·리셉션, 진행 앵글(진행 ASC·MC), 시너스트리 하우스 겹침은 돌려주지 않아요. 전체 목록은 레퍼런스에 있어요.
/natal-chart를 쓰고 있다면
네이탈 차트(/natal-chart)는 판매가 끝났어요. 새로 연동한다면 같은 출생 입력을 받는 /astrology를 쓰세요.
요청 예시
{
"birthDate": "1990-05-15",
"birthTime": "14:30",
"birthTimePrecision": "exact",
"birthLatitude": 37.5665,
"birthLongitude": 126.978,
"houseSystems": ["placidus", "whole_sign"]
}
인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.
응답 예시 (발췌)
{
"success": true,
"data": {
"natal": {
"utc": "1990-05-15T05:30:00.000Z",
"timePrecision": "exact",
"timeKnown": true,
"zodiac": "tropical",
"lang": "ko",
"bodies": [
{ "id": "Sun", "longitude": 54.1347, "sign": "Taurus", "signKey": "tau", "signName": "황소자리", "degreeInSign": 24.1347, "speed": 0.9643, "retrograde": false, "dignities": [], "house": { "placidus": 9, "whole_sign": 9 } },
{ "id": "Moon", "longitude": 293.8244, "sign": "Capricorn", "signKey": "cap", "signName": "염소자리", "degreeInSign": 23.8244, "speed": 12.2943, "retrograde": false, "dignities": ["det"], "house": { "placidus": 4, "whole_sign": 5 } },
…
위 요청 응답의 앞부분이에요. 교점·앵글·하우스·애스펙트까지 담긴 응답과 필드 설명은 레퍼런스에 있어요.
가격
점성술 토탈은 호출 1회에 ₩50(부가세 별도 · 부가세 포함 ₩55)이에요. timing·partner를 붙여도, 하우스 체계나 마이너 각 여부와 상관없이 같은 1회 가격이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.
한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.
전체 레퍼런스
파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 점성술 토탈 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.
문의: contact@float.do · 운영: 플로트 주식회사