> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-call.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証

> APIキーを Authorization ヘッダーで送ります。

すべてのリクエストに、APIキーを `Authorization: Bearer` ヘッダーで付けてください。

```bash theme={null}
curl https://api.ai-call.co/agents \
  -H "Authorization: Bearer aic_sk_..."
```

## APIキーを作る

1. 管理画面にログインし、「設定 → API」を開きます。
2. 名前と権限を選んで「APIキーを作成」を押します。
3. 表示されたキーをコピーして、安全な場所に保管します。

> [!WARNING]
>
> キーは作成したときに一度だけ表示されます。あとから確認することはできません。なくした場合は削除して作り直してください。キーはサーバー側で保管し、ブラウザやアプリに埋め込まないでください。

## 権限

キーごとに、使える操作を選べます。必要な権限だけを付けてください。

| 管理画面での名前 | 権限 | できること |
| - | - | - |
| 発信する | `calls:place` | 電話をかける、発信前の確認 |
| 通話を見る | `calls:read` | 通話の一覧・取得 |
| エージェント・電話番号を見る | `agents` | AIエージェント・電話番号の取得 |
| Webhookを設定する | `webhooks` | 送信先の追加・削除・テスト送信・送信記録 |

権限のない操作は `403 insufficient_scope` になります。

## 回数の上限

* APIキー1本あたり、1分120回まで（超えると `429 rate_limited`）。
* 電話をかけるのは、アカウントあたり1分60件・24時間2000件まで。
* 有効なAPIキーは1アカウント20件まで。

## キーを止める

管理画面の「設定 → API」でキーを削除すると、すぐに使えなくなります。漏れたおそれがあるときは、すぐに削除してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.