AstroWay API 문서

AstroWay API 기술 문서 허브. 761 엔드포인트 21개가 Swiss Ephemeris에 기반하며 OpenAPI 스펙을 지원하며, Postman과 Insomnia에 대한 준비된 컬렉션, TypeScript, Python, PHP를 위한 공식 SDK, MCP 서버.

Reference

API Reference 전체 761 엔드포인트 목록: 매개변수, 응답 스키마, 오류 코드. OpenAPI 스펙에 기반하여 각 릴리스마다 생성.

OpenAPI specification 자동으로 읽을 수 있는 스펙. Postman/Insomnia에 임포트하거나 openapi-generator를 통해 자신의 SDK를 생성하세요.

Postman collection 각 엔드포인트에 대한 예시 포함한 완비된 임포트 컬렉션.

Per-endpoint cost 각 엔드포인트의 비용 - 0부터 500 크레딧까지.

Start

Quick start 등록, 키 발급, 첫 번째 호출 - 5분 이내.

Authentication X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT for dashboard.

Credits & limits 크레딧 풀링, 월별 квotas, rate limits by plan.

Language support 21 active language. Localization of responses through `Accept-Language` (text content).

SDK & integrations

TypeScript SDK npm에서 공식 패키지 `@astroway/sdk`. ESM, Node 20+, browser-compatible.

Python SDK PyPI에서 공식 패키지 `astroway`. Sync 및 async 클라이언트, Python 3.9+.

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

MCP server `@astroway/mcp` - Model Context Protocol 서버 for Claude Desktop, Cursor 및 기타 AI-agents.

Engineering

Calculation accuracy Swiss Ephemeris arc-second precision. CI-snapshot 테스트 vs NASA Eclipse Catalog.

Errors 오류 코드 목록, HTTP 상태 코드 및 오류veloppe 구조.

Idempotency POST에 대한 안전한 retry를 위한 `Idempotency-Key` 헤더.

Versioning 버전 업데이트시 호환성 깨지지 않도록 하기 위해 버전 관리 방법.

Scenarios & examples

Product overview 네 개의 제품 그룹 - Birth Chart, Human Design, Synastry, Horoscope.

Vedic astrology 354+ 엔드포인트 - Vargas, dashas (8 시스템), Panchang, Shadbala, Yogas, Doshas.

Code examples 실제 예시 - birth chart, synastry, transit, Human Design, MCP.

Use cases AI-agents, astrology applications 및 dating platforms의 통합 예시.