# 개요

**AstroWay API** — 프로페셔널한 백엔드 астрологических 계산 서비스로 제공됩니다.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints}개의 Swiss Ephemeris(WASM) 기반 엔드포인트로, 경쟁사들이 제공하지 않는 기술들을 아우르고 있습니다: 하모닉 차트, 드래곤 차트, CCG, 고클랭 섹터, 완전한 Human Design, 출생시간 수정(rektification) 등.

## 대상자

1. **애플리케이션 개발자** (웹, 모바일) — 자체 계산 인프라 없이도 정확하고 다양한 계산이 필요한 경우.
2. **AI 기업** — Claude, ChatGPT 등 에이전트를 위한 네이티브 MCP 서버 지원.
3. **프로페셔널 점성가** — 고객을 위한 자체 도구나 스크립트 구축.
4. **연구자** — 통계 연구를 위한 프로그래밍 접근.
5. **컨텐츠 플랫폼** — 기존 제품에 점성 기능 추가.

## 대상자가 **아닌** 경우

- 오늘의 운세 위젯과 같은 단순 컨트롤 없는 горокоп — AI 해석 및 гороскоп API(`/interpret/*`, `/horoscope/*`)는 제공되지만, 개발자를 위한 API로 제공되며 готовый виджет가 아닙니다.
- 베다 점성학 — Dasha 시스템, Panchang, KP 등 베다 점성학에 특화된 VedicAstroAPI나 Prokerala를 권장합니다. 서양 점성학 + Human Design + 희귀 기술(렉티피케이션, 하모닉, CCG) 분야에서는 AstroWay가 뛰어납니다. 비교 페이지(/compare/)를 참고하세요.
- 타로/넘버로지 — 점성학과 Human Design만 제공됩니다.易经(I-Ching)은 보너스 엔드포인트로 제공됩니다.

## AstroWay만의 차별점

### 1. API로 제공되는 희귀 기술

| 기술 | 용도 |
|---|---|
| **하모닉 차트** (H2–H180) | 연구 점성학(존 애디 방법) |
| **드래곤 차트** | 카르마/영혼 점성학 |
| **CCG(Cyclo-Carto-Graphy)** | 진보된 Astro*Carto*Graphy — 짐 루이스의 프리미엄 기술 |
| **고클랭 섹터** | 통계 점성학, 학술적 사용 |
| **3차 прогрессия(Progressions)** | 제3의 прогре션 — 니치한 기술로 높이 평가됨 |
| **안티스키아 / 컨트라안티스키아** | 헬레니즘 전통 기술 — 전통 학교 부흥 |
| **패러럴 aspects** | 데칼리나에 따른 aspects — 고급 실무 |
| **렉티피케이션 via API** | 출생시간 수정 — 매우 높은 가치 |
| **플라네타리 싸이클** (콘쥰션) | 문다인 점성학 — 세계적 사건 |
| **바르보 사이클릭 인덱스** | 문다인 점성학 |
| **알골 미니멈** | 고정성 별의 시기 — 일렉티벌 점성학 |
| **로컬 스페이스 라인** | 펑수이와 유사한 방향 점성학 |
| **디스포지션 체인** | 그래프 관리 — 클래식 기술 |
| **알무텐 피구리스** | 중세 기술 — 전통 부흥 |

### 2. Swiss Ephemeris의 정확성 — Solar Fire($495), Kepler($995), Astro Gold에서도 사용되는 엔진

30년 이상 프로 점성가들이 Swiss Ephemeris(LGPL)를 사용해 왔습니다. 이제 WASM 빌드와 REST API로, 중간 마진 없이 제공됩니다. 정확성:

- 행성 위치: ±1 arc seconds vs NASA JPL ephemeris
- 하우스 커스피드: ±1 arc minutes
- Zet 9, Solar Fire(프로프라이터리 ephemeris), Astrodienst swetest CGI(Astro.com), Kepler, Astro Gold과의 검증 — 오차 범위 내(≤0.1″).

### 3. {siteMeta.endpoints}개의 엔드포인트 — 서양 점성 기술의 심층 커버리지

{siteMeta.westernCount}개의 서양 점성 계산 엔드포인트(4개 헬레니즘, 현대 심리학적, 진화론적, 코스모바이올로지) + AI 해석 + 완전한 Human Design. 여러 분야를 산재시키는 대신, 한 분야를 깊게 다룹니다.

## 아키텍처

```
당신의 애플리케이션
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
계산 후 JSON 반환
```

- 계산은 **서버 측**에서 수행됩니다. — 당신의 애플리케이션 프론트엔드에 WASM 블롭이 필요하지 않으며, Swiss Ephemeris 라이선스 문제도 없습니다.
- 서버 측 상태 저장 없음 — 모든 요청이 자체 완결적입니다. 고객 데이터 유출 위험 없습니다.
- API 키는 플랜, rate limit, 일일 크레딧 잔액에 연결됩니다. 대시보드를 통한 모니터링 가능.

## 다음 단계

- [빠른 시작](/getting-started/) — 5분 안에 첫 요청 보내기
- [인증](/authentication/) — API 키 발급 및 저장 방법
- [크레딧 및 한도](/rate-limits-credits/) — 과금 방식
- [API 문서](/docs/api/) — 모든 엔드포인트와 인터랙티브 플레이그라운드