AstroWay API ドキュメント

AstroWay API の技術ドキュメントのハブです。Swiss Ephemeris をベースにした 865 のエンドポイント、機械可読な OpenAPI スペック、Postman と Insomnia 用のコレクション、TypeScript・Python・PHP 向けの公式 SDK、Claude/Cursor 向けの MCP サーバーを提供しています。

Reference

API Reference 865 エンドポイントの完全なカタログ: パラメーター、レスポンススキーマ、エラーコード。リリースごとに OpenAPI spec から生成されます。

OpenAPI specification 機械可読なスペックです。Postman/Insomnia にインポートするか、openapi-generator で独自の SDK を生成できます。

Postman collection そのままインポートできるコレクションで、エンドポイントごとにサンプルが含まれています。

Per-endpoint cost エンドポイントごとのクレジット単価: 0 から 500 クレジットまで。

はじめに

クイックスタート 登録してキーを取得し、5 分で最初の呼び出しを行います。

認証 X-Api-Key と Bearer、live (aw_live_*) と sandbox (aw_test_*)、ダッシュボード用の JWT。

クレジットと制限 クレジットのプール、月間クォータ、プラン別のレート制限。

対応言語 21 の有効な言語。`Accept-Language` でレスポンスをローカライズします (テキストコンテンツ)。

SDK と統合

TypeScript SDK npm の公式パッケージ `@astroway/sdk`。ESM、Node 20+、ブラウザ対応。

Python SDK PyPI の公式パッケージ `astroway`。同期・非同期クライアント、Python 3.9+。

PHP SDK Packagist の公式パッケージ `astroway/sdk`。PSR-18 HTTP、PHP 8.1+。

MCP server `@astroway/mcp`: Claude Desktop、Cursor などの AI エージェント向け Model Context Protocol サーバー。

エンジニアリング

計算精度 Swiss Ephemeris による秒角単位の精度。NASA Eclipse Catalog と照合する CI スナップショットテスト。

エラー エラーコード、HTTP ステータスの一覧と error envelope の構造。

Idempotency POST を安全にリトライするための `Idempotency-Key` ヘッダー。

バージョニング バージョンの上げ方、互換性を壊す変更とは何か、changelog の読み方。

ユースケースとサンプル

製品概要 4 つの製品グループ: Birth Chart、Human Design、Synastry、Horoscope。

インド占星術 Vedic 向けの 354 以上のエンドポイント: Vargas、ダシャー (8 体系)、Panchang、Shadbala、Yogas、Doshas。

コードサンプル 出生図、シナストリー、トランジット、Human Design、MCP 向けのすぐに使えるスニペット。

Use cases 占星術アプリ、AI エージェント、出会い系プラットフォーム向けの統合シナリオ。