一般
AstroWay APIとは何か？
AstroWayは、プロフェッショナルなHTTP APIです。714エンドポイントを提供し、Swiss Ephemeris（WASM）をベースにしています。提供するサービスには、ナタルチャート、シナストリー、プログレッション、ディレクション、トランジット、ヒューマンデザイン、アストロカートグラフィー、レクティフィケーション、AI解釈などがあります。すべての計算はサーバー側で行われ、クライアント側には依存関係はありません。
このAPIは誰向け？
このAPIは、ウェブやモバイルのアストロロジーアプリを開発している開発者、AI企業がアストロロジー機能を追加している場合、スクリプトを使用しているプロフェッショナルなアストロロガー、計算へのプログラムアクセスが必要な研究者向けです。
計算の精度は？
Swiss Ephemerisは、惑星の位置の精度を±1角秒、ハウスのカスピットの精度を±1角分まで提供します。結果は、Astrodienst（Astro.com）、Solar Fire、Zet 9、Keplerと比較して検証されています。NASA JPLエフェメリスとNASA 5-Millennium Eclipse Catalogに対してサブアーク秒のドリフトがあります。
AstroWayはAstro.comまたはSolar Fireと比べてどうなの？
AstroWayは、Solar Fire（$495ライセンス）、Kepler（$995）、Astro Gold（$29.99/月）、Astrodienst（Astro.com）と同じSwiss Ephemerisエンジンを使用しています。NASA JPLエフェメリスとAstrodienstの公式swetestリファレンスに対して検証されています。惑星の位置のサブアーク秒ドリフト（≤0.1″）と、日食の≤1分のドリフトがあります。違いは、AstroWayは$5/月からのREST APIです。一回限りのライセンスやデスクトップGUIではありません。
サポートされているハウスシステムは？
15のハウスシステムをサポートしています。Placidus（デフォルト）、Koch、Whole Sign、Equal、Regiomontanus、Campanus、Topocentric、Alcabitius、Morinus、Porphyrius、Vehlow、Krusinski-Pisa、Hindu Bhava、APC、Equal from MCです。対応するコードをhouseSystemパラメータに渡してください。
クレジットと支払い
クレジットシステムの仕組み
各エンドポイントには、計算の複雑さに応じて10〜500クレジットの固定コストがかかります。シンプルなルックアップは10クレジット、ナタルチャートは20クレジット、シナストリーは50クレジット、レクティフィケーションは500クレジットです。完全な表は料金ページにあります。
無料プランはありますか？
はい。無料プランでは、月に10,000クレジット、1分あたり10リクエストが提供されます。カード情報の入力は不要です。製品の評価とプロトタイピングには十分です。
クレジットが不足した場合どうなりますか？
無料プランの場合、クレジットが不足すると、次の月までリクエストがブロックされます（429 CREDITS_EXHAUSTED）。Indie、Starter、Pro、Businessプランの場合、オーバージュールが適用されます。追加の10,000クレジットごとに$5、$3、または$2が請求されます。
同じリクエストはキャッシュされますか？
はい。5分間以内に同じ入力が行われた場合、キャッシュから返され、クレジットは消費されません。X-Cache: HITヘッダーで確認できます。
サブスクリプションなしでクレジットを購入できますか？
現在はできません。サブスクリプションにより、予測可能な予算とより優れたレート制限が提供されます。Pay-as-you-goプランは計画されています。
技術
利用可能なSDKは？
- MCPサーバー がリリースされています：
npx -y @astroway/mcp— Claude $1、Cursor、GPTなどのMCP互換AIエージェント向けのすべての714+エンドポイントをツールとして公開します。 - TypeScript SDK がリリースされています：
npm install @astroway/sdk— OpenAPI 3.1、リトライ、イデンプォテント、Stainlessスタイルのエラーを含む型とオートコンプリート。 - Python SDK がリリースされています：
pip install astroway— 同期Astrowayと非同期AsyncAstroway、httpxとPEP 561に基づいた型付き。 - PHP SDK がリリースされています：
composer require astroway/sdk— PHP 8.1以上、Guzzle 7とPSR-18、リトライミドルウェア。 - Go / Ruby / Rust は計画されています — 各SDKページ（
/sdk/<language>/）の電子メール通知に登録してください。 API契約は標準のREST + JSONなので、SDKなしで任意のHTTPクライアントを使用できます。PostmanコレクションとOpenAPI 3.1仕様は公開されています。
サンドボックスモードはありますか？
はい。aw_test_*キーのクレジットは消費されず、同じ結果が返されます。開発とテストに最適です。
レート制限は？
プランによって異なります。無料プランは10、Indieは30、Starterは120、Proは400、Businessは1,000リクエスト/分です。超過した場合、429エラーとRetry-Afterヘッダーが返されます。
Siderealゾディアックはサポートされていますか？
はい。"zodiacType": "sidereal"を渡し、オプションで"ayanamsaId"（デフォルトはLahiri）を指定してください。すべてのエンドポイントで機能します。
ヒューマンデザインエンドポイントとは？
ヒューマンデザインの計算用に12のエンドポイントがあります。タイプ、戦略、権威、プロフィール、定義、インカーネーションクロス、チャンネル、センター、Dream Rave、Hologenetic Profile、Penta（グループダイナミクス）、時間感度などです。商用APIの中で最も包括的なカバレッジです。
セキュリティとプライバシー
リクエストデータは保存されますか？
APIはステートレスで動作し、リクエストの処理後、日付/時刻/生年月日などのデータは保存されません。ログには、key_id、エンドポイント、タイムスタンプ、待ち時間、クレジットのみが含まれます。個人データはありません。
APIはGDPR要件を満たしていますか？
はい。データは保存されません。EUのユーザー向けに、個人情報の処理、プロファイリング、Cookieはありません。APIキーはアカウントに紐付いており、エンドユーザーには紐付いていません。
AI解釈は安全ですか？
AIエンドポイント（/interpret/*、/horoscope/*）には、安全性のガードレールが組み込まれています。医療、法務、財務に関するアドバイスは禁止されています。各レスポンスには免責事項が含まれています。エンタープライズコンプライアンスのための完全な監査トレイルがあります。
サポート
サポートを受けるには？
プランによって異なります。無料プランはコミュニティ、Indieは48時間以内にメール、Starterは24時間以内にメール、Proは4時間以内にメール、Businessは1時間以内にメールとSlack、エンタープライズはSlackの専用マネージャーです。連絡先は連絡先ページにあります。
SLAはありますか？
Indie: 99%のアップタイム。StarterとPro: 99.9%のアップタイム。Business: 99.95%のアップタイム。エンタープライズ: 金銭的保証を含むカスタムSLA。