カタログマップ: AstroWay の 700+ エンドポイントの構成

AstroWayカタログには、すでに57のグループに758個のエンドポイントがあります。この規模になると、インテグレーターにとっての主な問題は「カバー範囲が十分か」ではなく、「どうすれば迷子にならないか」です。この記事は、カタログがどのようにドメインに分割され、必要なものを1分で見つける方法を示すマップです。

ドメインに関わらず、すべての計算エンドポイントは同じ形式を持っています。

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

ボディは、出生データ（日付、時刻、座標）または技術固有のパラメータを含むJSONです。レスポンスは常に{ "ok": true, "data": {...} }または{ "ok": false, "error": {...} }です。GraphQLも、ドメインごとの個別の認証フローもありません。X-Api-Keyヘッダーに1つのキー、1つのレスポンス形式です。

これは、あなたがネイタルチャート用に書くラッパーが、BaZiやルーンにも適合することを意味します。変更されるのはパスとボディスキーマだけです。

カタログは大きなドメインにグループ化されています。以下は実際のカウンターを含むマップです（数値は各ビルドのマニフェストから取得されるため、常に最新です）。

その他には、AI解釈、ホロスコープ、参照エンドポイント（サイン、惑星、アスペクト）、およびシステム関連（health、usage、openapi）があります。

174個のヴェーダ占星術のエンドポイントは、西洋占星術全体よりも多いです。理由は単純で、ヴェーダの伝統はより形式化されているからです。西洋占星術が1つのハウスセットを持つ一方で、ヴェーダ占星術には16の分割図（ヴァルガ）、複数のダーシャーシステム、明確なルールを持つ数十のヨーガがあります。これらのそれぞれが、確定的な結果を持つ個別のエンドポイントです。

インド市場向けに構築する場合、これは製品の核であり、アドオンではありません。

技術の珍しさに関わらず、惑星の位置はSwiss Ephemeris (WASM) の単一のコアで計算されます。同じコアが私たちのアプリケーションのブラウザとAPIサーバーの両方で動作し、単一のコードベースで、差異はありません。計算エンドポイントは、各PRで参照ソースと照合される873個のスナップショットテストでカバーされています。これについては、CIの精度に関する別の記事で詳しく説明しています。

最も速いものから3つの方法があります。

1. OpenAPIリファレンス - /docs/api/ はopenapi.jsonのプロダクション仕様から直接生成されます。サイドバーのグループは上記のドメインに対応します。各エンドポイントには、ボディスキーマ、例、そして「試す」ボタンがあります。
2. MCPカタログ - ClaudeやCursorを使用している場合、カタログ全体はmcp.astroway.infoを通じてツールセットとして利用可能です。エージェントが説明に基づいて必要なエンドポイントを自動的に見つけます。
3. 仕様による検索 - curl https://api.astroway.info/v1/openapi.jsonは、完全な機械可読契約を返します。独自のクライアントのコード生成に便利です。

dashboard/sign-upでキーを取得すると、毎月10,000クレジットが付与されます。これは、数十のドメインを試して、どれがあなたにとって必要か理解するのに十分です。カタログ全体を学ぶ必要はありません。あなたのドメインを選び、残りは必要になったときに待っています。