AstroWay API 문서
AstroWay API 기술 문서 허브입니다. Swiss Ephemeris 기반의 781개 엔드포인트, 기계가 읽을 수 있는 OpenAPI 스펙, Postman과 Insomnia용 컬렉션, TypeScript, Python, PHP용 공식 SDK, Claude/Cursor용 MCP 서버를 제공합니다.
Reference
섹션 제목: “Reference” API Reference 전체 781개 엔드포인트 카탈로그: 파라미터, 응답 스키마, 오류 코드. 릴리스마다 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와 통합
섹션 제목: “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 읽는 법.