아스트로카토그래피 API

요청

실제 요청입니다. 데모 차트를 리스본에 맞춰 평가합니다.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

응답

위 요청에 대한 응답의 일부입니다. 주요 필드만 보여 주며, 목록은 모두 처음 세 항목으로 줄였습니다.

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

반환되는 내용

• relocated: 그 장소에서 차트가 갖는 어센던트와 천정.
• angularPlanets: 그 앵글에 놓인 행성과 각각의 앵글, 오브, 강도.
• spheres: 정체성, 사랑, 몸, 돈, 집, 정신의 점수로, 각각 0에서 10까지이며 5가 중립입니다. overall10 값이 이를 종합합니다.
• strength: 주요 행성이 앵글에서 2° 이내에 있으면 강함, 4° 이내면 보통, 그 밖에는 약함입니다. 이 규칙은 응답에 함께 담겨 있습니다.
• POST /v1/locations/rank 엔드포인트는 목록에서 가장 좋은 도시를 반환합니다. 여섯 영역 전체나 고른 영역을 기준으로, 전 세계 또는 한 지역 안에서 고릅니다.

제한 사항

• API Pro 전용입니다. 무료 키로 호출하면 두 엔드포인트 모두 업그레이드 링크와 함께 403을 반환합니다.
• 출생 시간이 필요합니다. 리로케이션은 앵글을 옮기고, 앵글은 출생 시간이 있어야 정해집니다.
• 순위는 지구상의 모든 곳이 아니라 주요 도시 61곳을 비교합니다. 다른 장소는 POST /v1/locations/score 엔드포인트로 점수를 매길 수 있습니다.
• 출생 정보는 읽고 쓴 뒤 잊습니다. 요청 본문은 저장하지 않습니다.

AI 어시스턴트에서

https://www.natalchart.ai/mcp의 MCP 서버를 통해 어시스턴트는 장소 하나에는 location_score 도구를, 가장 좋은 도시를 찾을 때는 best_cities 도구를 호출합니다.

API의 다른 기능

같은 키로 네이탈 차트, 일일 트랜짓, 시나스트리, 기간별 트랜짓, 솔라 리턴, 좋은 날, 아스트로카토그래피까지 점성술 API 전체를 쓸 수 있습니다. 모든 엔드포인트, 필드, 오류는 문서에 있으며, 무엇을 요청 1회로 세는지는 요금 페이지에서 볼 수 있습니다.

자주 묻는 질문