AstroWay API 문서

AstroWay API 기술 문서 허브입니다. Swiss Ephemeris 기반의 865개 엔드포인트, 기계가 읽을 수 있는 OpenAPI 스펙, Postman과 Insomnia용 컬렉션, TypeScript, Python, PHP용 공식 SDK, Claude/Cursor용 MCP 서버를 제공합니다.

Reference

API Reference 전체 865개 엔드포인트 카탈로그: 파라미터, 응답 스키마, 오류 코드. 릴리스마다 OpenAPI spec에서 생성됩니다.

OpenAPI specification 기계가 읽을 수 있는 스펙입니다. Postman/Insomnia로 가져오거나 openapi-generator로 직접 SDK를 생성하세요.

Postman collection 바로 가져올 수 있는 컬렉션으로, 엔드포인트마다 예제가 포함되어 있습니다.

Per-endpoint cost 엔드포인트별 크레딧 비용: 0에서 500 크레딧까지.

시작하기

빠른 시작 가입하고, 키를 발급받고, 5분 안에 첫 호출을 보내세요.

인증 X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), 대시보드용 JWT.

크레딧과 한도 크레딧 풀링, 월간 할당량, 요금제별 rate limit.

지원 언어 21개 활성 언어. `Accept-Language`로 응답을 현지화합니다(텍스트 콘텐츠).

SDK와 통합

TypeScript SDK npm의 공식 패키지 `@astroway/sdk`. ESM, Node 20+, 브라우저 호환.

Python SDK PyPI의 공식 패키지 `astroway`. 동기 및 비동기 클라이언트, Python 3.9+.

PHP SDK Packagist의 공식 패키지 `astroway/sdk`. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp`: Claude Desktop, Cursor 및 기타 AI 에이전트를 위한 Model Context Protocol 서버.

엔지니어링

계산 정확도 Swiss Ephemeris의 각초 단위 정밀도. NASA Eclipse Catalog와 대조하는 CI 스냅샷 테스트.

오류 오류 코드, HTTP 상태 코드 목록과 error envelope 구조.

Idempotency POST 요청을 안전하게 재시도하기 위한 `Idempotency-Key` 헤더.

버전 관리 버전을 올리는 방식, 호환성을 깨는 변경의 기준, changelog 읽는 법.

시나리오와 예제

제품 개요 네 가지 제품군: Birth Chart, Human Design, Synastry, Horoscope.

베다 점성술 Vedic용 354개 이상의 엔드포인트: Vargas, 다샤(8개 체계), Panchang, Shadbala, Yogas, Doshas.

코드 예제 출생 차트, 시나스트리, 트랜짓, Human Design, MCP를 위한 바로 쓸 수 있는 스니펫.

Use cases 점성술 앱, AI 에이전트, 데이팅 플랫폼을 위한 통합 시나리오.