FAQ answers

일반

AstroWay API가 뭐야?

전문적인 HTTP API로 점성술 계산을 제공해. 771 엔드포인트는 Swiss Ephemeris 기반이며: 출생 차트, 시냅시, 진행, 방향, 통과, Human Design, 천구지도, 정정, AI 해석. 모든 계산은 서버에서 이루어져서 클라이언트 쪽에 의존성이 없어.

이 API는 누구에게 필요해?

웹/모바일 점성술 앱을 만드는 개발자, 점성 기능을 추가하는 AI 회사, 스크립트를 사용하는 전문 점성가, 그리고 계산에 프로그래밍 접근이 필요한 연구자들을 위해.

계산 정확도는?

Swiss Ephemeris는 행성 위치를 ±1 초각, 하우스 커스피드까지 ±1 분각 정확도로 제공해. 결과는 Astrodienst(Astro.com), Solar Fire, Zet 9, Kepler와 비교 검증됐어. NASA JPL ephemeris와 NASA 5-Millennium Eclipse Catalog 대비 서브-아크초 드리프트.

AstroWay는 Astro.com이나 Solar Fire와 어떻게 비교돼?

같은 Swiss Ephemeris 엔진을 사용해 - Solar Fire($495 라이선스), Kepler($995), Astro Gold($29.99/월), Astrodienst(Astro.com)와 동일해. NASA JPL ephemeris와 Astrodienst의 공식 swetest reference와 검증됐어. 서브-아크초 드리프트(≤0.1″)는 행성 위치에, ≤1분은 일식/월식에 적용돼. 차이점은 AstroWay는 $5/월부터 이용 가능한 REST API라서 일회성 라이선스나 데스크톱 GUI가 필요 없어.

지원되는 하우스 시스템은?

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, 출생 차트는 20, 시냅시는 50, 정정은 500. 전체 표는 요금표 페이지에 있어.

무료 요금제가 있어?

응. Free 플랜은 월 10,000 크레딧, 분당 10 요청을 제공해. 카드 입력 없이 바로 쓸 수 있어. 제품 평가와 프로토타이핑에 충분해.

크레딧이 다 떨어지면 어떻게 돼?

Free 플랜에서는 다음 달까지 요청이 차단돼 (429 CREDITS_EXHAUSTED). Indie/Starter/Pro/Business 플랜에서는 초과 사용 시 10,000 추가 크레딧당 $5 / $3 / $2가 부과돼.

같은 요청이 캐시돼?

응. 동일한 입력은 5분 동안 캐시에서 반환돼서 크레딧이 차감되지 않아. X-Cache: HIT 헤더로 확인할 수 있어.

구독 없이 크레딧을 살 수 있어?

아직은 안 돼. 구독을 하면 예산을 예측할 수 있고 더 좋은 rate limit을 얻어. Pay-as-you-go는 계획 중이야.

기술적인 내용

어떤 SDK가 제공돼?

• MCP 서버 ✅ 출시됨: npx -y @astroway/mcp: 모든 771+ 엔드포인트를 Claude Desktop, Cursor, GPT 및 기타 MCP 호환 AI 에이전트를 위한 도구로 노출해
• TypeScript SDK ✅ 출시됨: npm install @astroway/sdk: 타입 + OpenAPI 3.1 기반 자동완성, 재시도 + 멱등성, 스테인리스 스타일 오류
• Python SDK ✅ 출시됨: pip install astroway: 동기 Astroway와 비동기 AsyncAstroway, httpx 기반, PEP 561 타입 지원
• PHP SDK ✅ 출시됨: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, 재시도 미들웨어
• Go / Ruby / Rust 📋 예정: 각 SDK 페이지(/sdk/<language>/)에서 이메일 알림을 구독해

API 계약은 표준 REST + JSON이라서 SDK 없이도 어떤 HTTP 클라이언트든 사용할 수 있어. Postman 컬렉션과 OpenAPI 3.1 스펙은 공개돼.

샌드박스 모드가 있어?

응. aw_test_* 키는 크레딧을 차감하지 않고 동일한 결과를 반환해. 개발 및 테스트에 딱 좋아.

레이트 리밋은?

플랜에 따라 달라: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1,000 req/min. 초과 시 429와 Retry-After 헤더가 반환돼.

sidereal 황도대가 지원돼?

응. "zodiacType": "sidereal"를 전달하고 옵션으로 "ayanamsaId"(기본값은 Lahiri)를 지정하면 돼. 모든 엔드포인트에서 작동해.

Human Design 엔드포인트가 뭐야?

Human Design 계산을 위한 12개의 엔드포인트가 있어: 타입, 전략, 권위, 프로필, 정의, 환생 십자, 채널, 센터, Dream Rave, Hologenetic Profile, Penta(그룹 역학), 시간 민감도. 상업용 API 중 가장 깊은 HD 커버리지야.

보안 및 프라이버시

요청 데이터가 저장돼?

API는 stateless라서 출생 날짜/시간/좌표 같은 데이터는 요청 처리 후 저장되지 않아. 로그에는 key_id, 엔드포인트, timestamp, latency, 크레딧만 기록돼. 개인 데이터는 전혀 없어.

API가 GDPR 요구사항을 충족해?

응. 데이터가 저장되지 않아. EU 사용자에게는 PII 처리도, 프로파일링도, 쿠키도 없어. API 키는 계정에 연결돼 있고 최종 사용자와는 연결되지 않아.

AI 해석은 안전해?

AI 엔드포인트(/interpret/*, /horoscope/*)에는 내장된 안전 가드레일이 있어: 의료, 법률, 재무 조언을 금지해. 모든 응답에 면책 조항이 포함돼. 전체 감사 로그는 엔터프라이즈 컴플라이언스를 위해 제공돼.

지원

도움은 어떻게 받아?

플랜에 따라 달라: Free - 커뮤니티, Indie - 이메일(48시간), Starter - 이메일(24시간), Pro - 이메일(4시간), Business - 이메일 + Slack(1시간), Enterprise - Slack 전용 매니저. 연락처는 연락처 페이지에 있어.

SLA가 있어?

Indie: 99% 가동 시간. Starter와 Pro: 99.9% 가동 시간. Business: 99.95% 가동 시간. Enterprise: 재정 보장을 포함한 맞춤형 SLA.

비슷한 이름

AstroWay API(astroway.info)가 astroway.life의 ‘Astroway’ 구독과 관련돼?

아니. astroway.info와 api.astroway.info는 별개의 독립적인 회사야. 우리는 개발자를 위한 점성술 API (api.astroway.info), 최종 사용자를 위한 앱 (app.astroway.info), 그리고 점성가 상담을 제공해. 우리는 ‘Astroway’라는 소비자 점성술 구독과 전혀 관계가 없어, 이는 astroway.life를 통해 광고되고 청구돼 (no-reply@astroway.life에서 온 메일, 인물 ‘Celeste’, 은행 명세서에 ‘Astroway’ 표시). 이 구독의 운영자는 TrafficLeader OÜ(에스토니아, traffic-leader.com도 포함); 연관 빌러 SKYREAD.PRO는 ABCMobile OÜ(에스토니아)야. 이름이 비슷할 뿐, 전혀 다른 회사야.

‘Astroway’가 청구돼 - 구독을 취소하고 환불받으려면?

‘Astroway’ 구독료가 청구된다면 (no-reply@astroway.life에서 온 메일, 은행 명세서에 ‘Astroway’ 표시), 이는 다른 회사인 astroway.life이며 우리와는 무관해. 우리는 해당 서비스의 계정이나 결제에 접근할 수 없으니 구독을 취소하거나 환불을 해줄 수 없어. 다음과 같이 해:

1. no-reply@astroway.life에 직접 답장하고 메일 하단의 “구독 취소/해지” 링크를 클릭해.
2. 응답이 없으면 은행이나 카드 발급사에 연락해 (명세서에 ‘Astroway’; 가맹점은 TrafficLeader OÜ 또는 ABCMobile OÜ / SKYREAD.PRO, 에스토니아) 반복 청구를 차단하거나 환불(차지백)을 요청해.