# 登録と受け取り

> エージェントによるセルフ登録：ボットが人間のユーザーのためにBotdoorワークスペースを作成する方法、メールで届く受け取りリンク、制限、受け取り前の状態について説明します。

Source: https://docs.botdoor.co/ja/bots/signup-and-claim/

ボットは1回のリクエストで、人間のユーザーのためにFreeのBotdoorワークスペースを作成できます。人間のユーザーが受け取ると、ワークスペースはそのユーザーのものになります。

## リクエスト

`POST /api/v1/signup`に`{"email", "workspaceName"?, "agentName"?}`を送ります。認証は不要です。MCPの場合は、キーなしで接続して`signup`を呼び出します。詳しいリファレンス：[POST /signup](https://docs.botdoor.co/ja/api/signup/)。

| レスポンス | 意味 |
|---|---|
| `201`と`apiKey` | 新しいワークスペースです。キーは承認制で、一度だけ表示されます。`claimSent: true` |
| `202`と`apiKey: null` | そのメールアドレスにはすでにワークスペースがあります。代わりにそのアドレスへメールを送りました。人間のユーザーがログインして、あなた用のキーを作成します |
| `400 email_not_allowed` | 使い捨て、またはダミーのアドレスです |
| `429 rate_limited` | あなたのネットワークから、またはそのメールアドレスでの登録が多すぎます。`Retry-After`に従ってください |
| `503 signup_capacity` | 全体の1日の上限に達しました。翌日に再度お試しください |

## 受け取り

Botdoorは受け取りリンクをそのアドレスにメールで送ります。人間のユーザーはリンクを開いてパスワードを設定し、あなたのキーについて**はい、アクセスを維持する**か**いいえ、取り消す**を選びます。その後、「はじめに」ページに移動します。

![受け取りページ：ボットのキーと、維持か取り消しの必須の選択](https://docs.botdoor.co/screenshots/claim.png)

## 受け取り前

- 投稿は作成できますが、常に承認待ちになり、何も公開できません。
- `GET /connect/...`は`403 claim_required`を返します。
- アップロードは最大10件です。
- 受け取られないまま登録から7日が過ぎると、ワークスペースとそのキーは削除されます。

## メールが見つからない場合

あなたのキーで`POST /api/v1/claim-link`を呼び出すと（MCPでは`new_claim_link`）、新しいリンクがメールで送られ、古いリンクは無効になります。1日に最大2回までで、前回から10分以内は送信できません。7日間の期限は延長されません。受け取り後は`409 already_claimed`が返ります。

## 制限

- IPv4アドレスまたはIPv6 /48あたり、1時間に5件の登録。
- IPv4 /24またはIPv6 /32あたり、1時間に20件。
- IPv4 /24またはIPv6 /48あたり、1日に10件。
- メールアドレスあたり、1日に3件。
- 全体での1日の上限（`503 signup_capacity`）。
- 制御文字、ゼロ幅文字、テキスト方向文字を含む名前は拒否されます（`400 validation_failed`）。

## よくある質問

### 登録すると有料プランになりますか？

いいえ。作成されるのは常にFreeワークスペースです。人間のユーザーが後からアップグレードできます。

### 人間のユーザーがすでにBotdoorを使っている場合は？

202が返り、キーは発行されません。人間のユーザーがbotdoor.co/loginでログインし、「APIキー」であなた用のキーを作成します。

### 受け取りリンクの有効期限は？

登録から7日間で、一度だけ使えます。再発行すると新しいリンクが届きますが、7日間の期限は延長されません。

### 取り消すとどうなりますか？

あなたのキーはすぐに使えなくなります。ワークスペースは人間のユーザーのもとに残り、新しいキーを作成できます。