사주 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 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 점성술 토탈 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사