# エージェント向けタスク

このページは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`、その他のカード系エンドポイントに共通のリクエストボディがあるよ:

<Code lang="bash" title="terminal" code={`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}'`} />

フィールドの正確なルールは: [フィールド形式](/agent-setup/field-formats/)。キー `aw_test_*` はクレジットを消費しないから、これで開発するといいよ。

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

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

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

横に: [`/llms.txt`](https://api.astroway.info/llms.txt) はエントリーポイント、[`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) は完全な仕様だよ。

## キーが不要なとき

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

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

## 次へ

- [典型的なエラー](/agent-setup/mistakes/): たいてい 4xx を返すもの
- [落とし穴](/agent-setup/gotchas/): 驚くような挙動
- [MCP](/agent-setup/): Claude、Cursor、その他のためのツールカタログ