エージェント向けタスク

このページは30日間の販売ログから作成したもので、想像ではない。以下はキーを使って実際に統合者が行っている呼び出しで、頻度順だよ。

最も頻繁に呼び出されるもの

エンドポイント	30日間の成功呼び出し数	目的
POST /v1/human-design	12 563	ボディグラフ: タイプ、プロファイル、権威、チャンネル
POST /v1/chart	11 763	出生図: 惑星、ハウス、アスペクト
POST /v1/transits	1 999	出生時点へのトランジット
POST /v1/vedic/dashas/vimshottari/maha	1 272	ヴィムショッタリ・マハのヴェーダ期間
POST /v1/houses	861	カスピッドと角度のみ、惑星なし
POST /v1/planets	761	天体の位置のみ
POST /v1/acg	704	アストロカートグラフィ、世界のライン
POST /v1/transit-calendar	678	期間のトランジットカレンダー
POST /v1/horoscope/daily	549	1日分のテキスト (AI)
POST /v1/synastry	437	2枚のチャートの相性

GET /v1/auth/keys/me (262) も同じリストにあるよ: エージェントは作業前にキーをチェックするんだ。これは無料で、クレジットは消費しない。

最小限の呼び出し

chart、houses、planets、human-design、transits、その他のカード系エンドポイントに共通のリクエストボディがあるよ:

terminal

curl -X POST https://api.astroway.info/v1/chart \
-H "X-Api-Key: aw_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'

フィールドの正確なルールは: フィールド形式。キー aw_test_* はクレジットを消費しないから、これで開発するといいよ。

仕様を読むべきで、当てずっぽうはやめよう

各オペレーションページには markdown の複製 があるんだ: 同じ URL に .md を付けるだけ。HTML の代わりにモデルに渡すべきだよ。

terminal

curl https://api.astroway.info/docs/api/operations/acg_categories_get.md

横に: /llms.txt はエントリーポイント、/v1/openapi.json は完全な仕様だよ。

キーが不要なとき

キーなしで動く名前空間が3つあり、すべてIPごとに制限があるよ: /v1/public/*（ページ 無料 に列挙された9つの計算エンドポイント）、/v1/embed/*（完成ウィジェット）と /v1/reference/*（リファレンス: サイン、惑星、アスペクト）。

キーなしのレスポンスには _footer フィールドが付くんだ、これは無料レベルのマークで、問題ないよ。

次へ

• 典型的なエラー: たいてい 4xx を返すもの
• 落とし穴: 驚くような挙動
• MCP: Claude、Cursor、その他のためのツールカタログ