# 점성술 앱 개발
AstroWay API를 사용해 Co-Star, Sanctuary, The Pattern, Chani, Costar Compat 같은 앱을 만들고 있나요? AstroWay API는 Solar Fire($495) 라이선스를 구매하거나 자체 에페머리스 엔진을 개발할 필요가 없습니다. {siteMeta.endpoints}개의 엔드포인트(출생 차트, 시너스트리, 트랜짓, 휴먼 디자인, AI 해석)를 제공하며, OpenAPI 3.1 규격으로 TS/Python SDK(roadmap 진행 중)까지 생성할 수 있습니다. Swiss Ephemeris 엔진을 사용해 Astrodienst와 Kepler와 동일한 정밀도를 제공합니다.
## 일반적인 아키텍처
```
사용자 (브라우저 / 모바일)
↓
당신의 백엔드 (Node.js / Python / PHP)
↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
↓
JSON 응답 → 당신의 UI에서 렌더링
```
## астро 앱을 위한 주요 엔드포인트
### MVP (최소 기능 제품)
| 엔드포인트 | 크레딧 | 용도 |
|---|---|---|
| `/v1/chart` | 20 | 출생 차트 생성 |
| `/v1/synastry` | 50 | 두 사람의Compatibility 분석 |
| `/v1/horoscope/daily` | 20 | 일일 호로스코프 |
세 가지 엔드포인트만으로도 출생 차트,Compatibility 분석, 일일 콘텐츠가 포함된 기본 앱을 만들 수 있습니다.
### 확장형 제품
| 엔드포인트 | 크레딧 | 용도 |
|---|---|---|
| `/v1/transits` | 50 | 현재 트랜짓 분석 |
| `/v1/solar-return` | 50 | Solar Return(연간 차트) |
| `/v1/progressions` | 50 | 2차 прогре션 |
| `/v1/interpret/natal` | 50 | AI 기반 출생 차트 해석 |
| `/v1/transit-calendar` | 100 | 트랜짓 이벤트 캘린더 |
| `/v1/human-design` | 50 | 휴먼 디자인 차트 |
### 프리미엄 기능
| 엔드포인트 | 크레딧 | 용도 |
|---|---|---|
| `/v1/rectification` | 500 | 출생 시간 보정 |
| `/v1/acg` | 50 | AstroCartography(어디서 살기 좋은지) |
| `/v1/forecast-calendar` | 100 | 연간 Forecast Heatmap |
| `/v1/group-synastry` | 100 | 그룹Compatibility 분석 |
## 예산 추정
### 시나리오: 100 DAU (일일 활성 사용자 100명)
평균 사용자가 하루에 3번의 액션을 한다고 가정:
| 액션 | 엔드포인트 | 크레딧 | 요청/일 | 일일 크레딧 |
|---|---|---|---|---|
| 차트 조회 | `/v1/chart` | 20 | 100 | 2,000 |
| 일일 호로스코프 | `/v1/horoscope/daily` | 20 | 100 | 2,000 |
|Compatibility 분석 | `/v1/synastry` | 50 | 30 | 1,500 |
| **합계** | | | **230** | **5,500/일** |
**월간 약 165,000 크레딧** (5,500 × 30) → **Starter 요금제($19/월, 200,000 크레딧)**로 21% 여유분을 확보하거나, **Indie 요금제($5/월, 50,000 크레딧)**에서 초과분에 대해 약 $5(110K 크레딧 초과)의 추가 비용 발생.
### 시나리오: MVP with 20 DAU
| 액션 | 일일 크레딧 |
|---|---|
| 20개 차트 | 400 |
| 20개 호로스코프 | 400 |
| 5개Compatibility 분석 | 250 |
| **합계** | **1,050/일** |
**월간 약 31,500 크레딧** → **Indie 요금제($5/월, 50,000 크레딧)**로 충분.
## 팁
- **출생 차트는 캐시** — 입력값(생년월일)이 변하지 않으므로 결과를 영구적으로 캐시할 수 있습니다.
- **호로스코프는 하루 단위로 캐시** — 동일한 별자리 사용자의 일일 호로스코프는 동일하므로 한 번 생성 후 재사용하세요.
- **샌드박스 키(`aw_test_*`)** — 개발용으로 크레딧이 소모되지 않습니다.
- **OpenAPI 3.1 Codegen** — `/v1/openapi.json`을 `openapi-typescript` 또는 `openapi-python-client`에 넣으면 타입이 지정된 클라이언트를 자동 생성할 수 있습니다(준비 중인 SDK).