# アストロロジーアプリケーション

AstroWay APIを使って、Co-Star、Sanctuary、The Pattern、Chani、Costar Compatのようなアストロロジーアプリを構築しよう。AstroWay APIは、Solar Fire（$495）をライセンス購入する必要性や、独自のエフェメリスエンジンを開発する手間を解消します。{siteMeta.endpoints}のエンドポイント（ホロスコープ、シナストリー、トランジット、ヒューマンデザイン、AI解釈など）を提供し、OpenAPI 3.1に準拠しているため、型付きクライアント（TS / Python SDKはロードマップにて準備中）を生成できます。Swiss Ephemerisの精度は、AstrodienstやKeplerと同じエンジンを採用しています。

## 典型的なアーキテクチャ

```
ユーザー（ブラウザ / モバイル）
     ↓
あなたのバックエンド（Node.js / Python / PHP）
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSONレスポンス → あなたのUIでレンダリング
```

<Aside type="caution">
APIキーをフロントエンドコードに埋め込まないでください。AstroWay APIの呼び出しは、必ずあなたのバックエンドまたはサーバー関数（Next.js API routes、Vercel Functions、AWS Lambdaなど）経由で行ってください。
</Aside>

## アストロアプリに必須の主要エンドポイント

### MVP（最小限の製品）

| エンドポイント | クレジット | 用途 |
|---|---|---|
| `/v1/chart` | 20 | ホロスコープ（ナタルチャート）の生成 |
| `/v1/synastry` | 50 | 2人の相性診断 |
| `/v1/horoscope/daily` | 20 | 日別ホロスコープ |

3つのエンドポイントがあれば、ナタルチャート、相性診断、日別コンテンツを備えた動作可能な製品がすぐに完成します。

### 拡張製品

| エンドポイント | クレジット | 用途 |
|---|---|---|
| `/v1/transits` | 50 | ナタルチャートに対する現在のトランジット |
| `/v1/solar-return` | 50 | ソーラーリターン（年間チャート） |
| `/v1/progressions` | 50 | セカンダリープログレッション |
| `/v1/interpret/natal` | 50 | ナタルチャートのAI解釈 |
| `/v1/transit-calendar` | 100 | トランジットイベントのカレンダー |
| `/v1/human-design` | 50 | ヒューマンデザインチャート |

### プレミアム機能

| エンドポイント | クレジット | 用途 |
|---|---|---|
| `/v1/rectification` | 500 | 出生時刻の補正 |
| `/v1/acg` | 50 | アストロカルトログラフィー（居住地の最適な場所） |
| `/v1/forecast-calendar` | 100 | 年間予測ヒートマップ |
| `/v1/group-synastry` | 100 | グループ相性診断 |

## 予算見積もり

### シナリオ：100 DAU（デイリーアクティブユーザー）

平均的なユーザーが1日に3回の操作を行うと仮定します。

| 操作 | エンドポイント | クレジット | リクエスト/日 | クレジット/日 |
|---|---|---|---|---|
| チャート表示 | `/v1/chart` | 20 | 100 | 2,000 |
| 日別ホロスコープ | `/v1/horoscope/daily` | 20 | 100 | 2,000 |
| 相性診断 | `/v1/synastry` | 50 | 30 | 1,500 |
| **合計** | | | **230** | **5,500/日** |

**月間約165,000クレジット**（5,500 × 30）→ **Starterプラン（$19/月、200,000クレジット）**で21%の余裕があります。または**Indieプラン（$5/月、50,000クレジット）**で、追加110Kクレジットにつき約$5の超過料金が発生します。

### シナリオ：MVP（20 DAU）

| 操作 | クレジット/日 |
|---|---|
| 20チャート | 400 |
| 20日別ホロスコープ | 400 |
| 5相性診断 | 250 |
| **合計** | **1,050/日** |

**月間約31,500クレジット** → **Indieプラン（$5/月、50,000クレジット）**でカバーできます。

## Tips

- **ナタルチャートはキャッシュしよう** — 入力データ（生年月日）は不変なので、結果を永久に自分のDBにキャッシュできます
- **ホロスコープは1日単位でキャッシュしよう** — 日別ホロスコープは同じ星座の人全員にとって同じ内容なので、一度生成して配布しましょう
- **サンドボックスキー**（`aw_test_*`） — 開発用で、クレジットは消費されません
- **OpenAPI 3.1からのコード生成** — `/v1/openapi.json`を`openapi-typescript`や`openapi-python-client`に入力すれば、型付きクライアントを入手できます（SDKはロードマップにて準備中）

<CardGrid>
  <LinkCard title="クイックスタート →" href="/getting-started/" description="5分で最初のリクエスト" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="ナタルチャートについて詳しく解説" />
  <LinkCard title="料金プラン" href="/pricing/" description="無料からエンタープライズまで" />
</CardGrid>