일반 정보
AstroWay API란 무엇인가요?
프로페셔널 HTTP API로, 천문 계산(점성술 계산)을 위한 것입니다. Swiss Ephemeris(WASM 기반)의 723 엔드포인트를 제공합니다: natal chart, synastry, progression, direction, transit, Human Design, astrocartography, rectification, AI 해석 등. 모든 계산은 서버에서 수행되며 클라이언트 측 종속성은 없습니다.
이 API는 누구를 위한 것인가요?
웹/모바일 점성술 애플리케이션을 개발하는 개발자, AI 기업(점성술 기능 추가), 스크립트를 사용하는 프로페셔널 점성가, 그리고 계산에 프로그램적 접근이 필요한 연구자들을 위한 것입니다.
계산 정확도는 어느 정도인가요?
Swiss Ephemeris는 행성 위치 정확도를 ±1 각초까지, 하우스 쿠스프 정확도를 ±1 각분까지 보장합니다. 결과는 Astrodienst(Astro.com), Solar Fire, Zet 9, Kepler와 비교 검증되었습니다. NASA JPL ephemeris 및 NASA 5천년 일식 카탈로그 대비 서브 각초 수준의 drift를 보입니다.
AstroWay는 Astro.com이나 Solar Fire와 어떻게 비교되나요?
Swiss Ephemeris 엔진이 동일합니다. Solar Fire($495 라이선스), Kepler($995), Astro Gold($29.99/월), Astrodienst(Astro.com)와 동일한 엔진입니다. NASA JPL ephemeris 및 Astrodienst 공식 swetest 레퍼런스와 검증되었습니다. 행성 위치에서 서브 각초(≤0.1″) 수준, 일식에서 ≤1분 수준의 drift를 보입니다. 차이점: AstroWay는 one-time 라이선스나 데스크톱 GUI가 아닌 월 $5부터 시작하는 REST API입니다.
어떤 하우스 시스템을 지원하나요?
15개 시스템 지원: 기본값인 Placidus, Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC, MC Equal. houseSystem 매개변수로 해당 코드를 전달하세요.
크레딧 및 결제
크레딧 시스템은 어떻게 작동하나요?
각 엔드포인트는 계산 복잡도에 따라 고정된 크레딧 비용(10~500)이 청구됩니다. 간단한 lookup은 10, natal chart는 20, synastry는 50, rectification은 500입니다. 전체 표는 요금제 페이지에서 확인하세요.
무료 요금제가 있나요?
네. Free 플랜은 월 10,000 크레딧, 분당 10 요청을 제공합니다. 카드 입력 없이 사용 가능하며, 제품 평가 및 프로토타입 작성에 충분합니다.
크레딧이 소진되면 어떻게 되나요?
Free 플랜에서는 다음 달까지 요청이 차단됩니다(429 CREDITS_EXHAUSTED). Indie/Starter/Pro/Business 플랜에서는 초과 사용료가 청구됩니다: $5/$3/$2 per 10,000 크레딧.
동일한 요청은 캐시되나요?
네. 동일한 입력은 5분 동안 캐시되어 크레딧이 소진되지 않고 반환됩니다. X-Cache: HIT 헤더로 확인할 수 있습니다.
구독 없이 크레딧을 구매할 수 있나요?
현재는 불가능합니다. 구독은 예측 가능한 예산과 더 나은 rate limit을 제공합니다. Pay-as-you-go 플랜은 계획 중입니다.
기술적 세부 사항
제공되는 SDK는 무엇인가요?
- MCP 서버 ✅ 릴리스됨:
npx -y @astroway/mcp— 모든 723 엔드포인트를 Claude $1, Cursor, GPT 등 MCP 호환 AI 에이전트의 도구로 노출 - TypeScript SDK ✅ 릴리스됨:
npm install @astroway/sdk— OpenAPI 3.1 기반 타입 + 자동완성, retry + idempotency, Stainless 스타일 에러 처리 - Python SDK ✅ 릴리스됨:
pip install astroway— 동기Astroway+ 비동기AsyncAstroway,httpx기반, PEP 561 typed - PHP SDK ✅ 릴리스됨:
composer require astroway/sdk— PHP 8.1+, Guzzle 7 + PSR-18, retry 미들웨어 - Go / Ruby / Rust 📋 계획됨 — 각 SDK 페이지(
/sdk/<language>/)에서 이메일 알림 구독 가능
API 계약은 표준 REST + JSON으로, SDK 없이도 모든 HTTP 클라이언트가 동작합니다. Postman 컬렉션과 OpenAPI 3.1 spec이 공개되어 있습니다.
샌드박스 모드는 있나요?
네. aw_test_* 키는 크레딧을 소진하지 않으며 동일한 결과를 반환합니다. 개발 및 테스트에 적합합니다.
rate limit은 어떻게 되나요?
플랜에 따라 다릅니다: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1,000 req/분. 초과 시 429 오류와 Retry-After 헤더가 반환됩니다.
sidereal 황도대는 지원하나요?
네. "zodiacType": "sidereal" 및 선택적 "ayanamsaId"(기본값: Lahiri)를 전달하세요. 모든 엔드포인트에서 동작합니다.
Human Design 엔드포인트는 무엇인가요?
Human Design 계산을 위한 12개 엔드포인트: 유형, 전략, 권한, 프로필, 정의, 인카네이션 십자가, 채널, 센터, Dream Rave, Hologenetic Profile, Penta(그룹 역학), 시간 민감성. 상업용 API 중 가장 포괄적인 Human Design 지원입니다.
보안 및 개인정보 보호
요청 데이터는 저장되나요?
API는 stateless로 동작합니다. 요청 후 출생 날짜/시간/좌표 데이터는 저장되지 않으며, 메타데이터(키 ID, 엔드포인트, 타임스탬프, latency, 크레딧)만 로깅됩니다. 개인정보는 저장되지 않습니다.
API는 GDPR 규정을 준수하나요?
네. 데이터가 저장되지 않으며, EU 사용자를 위한 특별 조치: PII 처리 금지, 프로파일링 금지, 쿠키 미사용. API 키는 계정에 연결되며 최종 사용자와 연결되지 않습니다.
AI 해석은 안전한가요?
AI 엔드포인트(/interpret/*, /horoscope/*)에는 안전 가드레일이 내장되어 있습니다: 의료, 법률, 재정 조언 금지. 모든 응답에 disclaimer가 포함됩니다. 전체 감사 추적은 엔터프라이즈 컴플라이언스를 위해 제공됩니다.
지원
어떻게 도움을 받을 수 있나요?
플랜에 따라 다릅니다: Free — 커뮤니티, Indie — 이메일(48시간), Starter — 이메일(24시간), Pro — 이메일(4시간), Business — 이메일 + Slack(1시간), Enterprise — 전용 Slack 관리자. 연락처는 문의하기 페이지에서 확인하세요.
SLA는 제공되나요?
Indie: 99% uptime. Starter 및 Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: 재정적 보장과 함께 맞춤형 SLA.