# 概要

**AstroWay API** — プロフェッショナルなバックエンド REST API で、占星術計算をサービスとして提供します。

<GetApiKeyBlock variant="compact" /> Swiss Ephemeris (WASM) をベースにした {siteMeta.endpoints} のエンドポイントを提供しており、他の追随を許さない技術を網羅しています：ハーモニックチャート、ドラゴニックチャート、CCG、ゴクランのセクター、完全な Human Design、出生時刻の修正（レクティフィケーション）などです。

## 対象者

1. **占星術アプリケーション開発者**（Web、モバイル）向け：正確で多様な計算を、自前の計算インフラなしで実現できます。
2. **AI企業**向け：Claude、ChatGPT などのエージェント向けに、ネイティブの MCP サーバーを提供しています。
3. **プロの占星術師**向け：顧客向けの独自ツールやスクリプトを構築する際に活用できます。
4. **研究者**向け：統計調査のためのプログラムアクセスを提供します。
5. **コンテンツプラットフォーム**向け：既存のプロダクトに占星術機能を追加できます。

## 対象外

- 今日の星座占いなどの「ワン・クリック」ウィジェット：`/interpret/*` や `/horoscope/*` では AI 解釈やホロスコープを提供していますが、開発者向け API として設計されており、完成されたウィジェットではありません。
- ベーダ占星術を主軸とするプロジェクト：ダシャシステム、パンチャンガ、KP などに特化した VedicAstroAPI や Prokerala が強力です。西洋占星術 + Human Design + レア技法（レクティフィケーション、ハーモニクス、CCG）に特化した AstroWay が優れています。詳細は /compare/ をご覧ください。
- タロットや数秘術：占星術と Human Design、そしてボーナスエンドポイントとして I-Ching のみを提供しています。

## AstroWay のユニークな特徴

### 1. レア技法を API で提供

| 技法 | 用途 |
|---|---|
| **ハーモニックチャート** (H2–H180) | 研究占星術（ジョン・アデイの手法） |
| **ドラゴニックチャート** | カルマ/魂の占星術 |
| **CCG（サイクロ・カルト・グラフィー）** | 進歩天宮図 — ジェームズ・ルイスのプレミアム技法 |
| **ゴクランのセクター** | 統計占星術、学術利用 |
| **三次進化（サード・プログレッション）** | 3 番目の進化タイプ — ニッチながら高い評価 |
| **アンティスキア / コントラアンティスキア** | 古典的ヘレニズム技法 — 伝統校の復興 |
| **パラレルアスペクト** | 10度区切りのアスペクト — 上級実践 |
| **API によるレクティフィケーション** | 出生時刻の修正 — 非常に価値の高い機能 |
| **惑星サイクル**（コンジャンクション） | Mundane 占星術 — 世界的出来事 |
| **バルボーのサイクリック・インデックス** | Mundane 占星術 |
| **アルゴルの最小光度** | 不動の恒星の時代 — エレクショナル占星術 |
| **ローカルスペースライン** | フェン・シュイに似た方位占星術 |
| **ディスポジションチェーン** | 管理グラフ — 古典技法 |
| **アルムテン・フィギュリス** | 中世技法 — 伝統の復興 |

### 2. Swiss Ephemeris の精度 — Solar Fire（$495）、Kepler（$995）、Astro Gold でも採用されているエンジン

30年以上にわたりプロの占星術師に愛用されてきた Swiss Ephemeris（LGPL）を、WASM ビルドかつ REST API として提供します。仲介業者のマージンなしで、以下の精度を実現：

- 惑星位置：NASA JPL エフェメリスと比較して ±1 秒角
- ハウスカップ：±1 分角
- 検証：Zet 9、Solar Fire（プロプライエタリ・エフェメリス）、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 キーはプラン、レート制限、日次クレジット残高に紐付けられています。ダッシュボードでモニタリング可能です。

## 次へ

- [クイックスタート](/getting-started/) — 5 分で最初のリクエスト
- [認証](/authentication/) — API キーの取得と保存方法
- [クレジットと制限](/rate-limits-credits/) — 課金の仕組み
- [API ドキュメント](/docs/api/) — すべてのエンドポイントとインタラクティブなプレイグラウンド