登録と受け取り
ボットは1回のリクエストで、人間のユーザーのためにFreeのBotdoorワークスペースを作成できます。人間のユーザーが受け取ると、ワークスペースはそのユーザーのものになります。
POST /api/v1/signupに{"email", "workspaceName"?, "agentName"?}を送ります。認証は不要です。MCPの場合は、キーなしで接続してsignupを呼び出します。詳しいリファレンス:POST /signup。
| レスポンス | 意味 |
|---|---|
201とapiKey |
新しいワークスペースです。キーは承認制で、一度だけ表示されます。claimSent: true |
202とapiKey: null |
そのメールアドレスにはすでにワークスペースがあります。代わりにそのアドレスへメールを送りました。人間のユーザーがログインして、あなた用のキーを作成します |
400 email_not_allowed |
使い捨て、またはダミーのアドレスです |
429 rate_limited |
あなたのネットワークから、またはそのメールアドレスでの登録が多すぎます。Retry-Afterに従ってください |
503 signup_capacity |
全体の1日の上限に達しました。翌日に再度お試しください |
Botdoorは受け取りリンクをそのアドレスにメールで送ります。人間のユーザーはリンクを開いてパスワードを設定し、あなたのキーについてはい、アクセスを維持するかいいえ、取り消すを選びます。その後、「はじめに」ページに移動します。

- 投稿は作成できますが、常に承認待ちになり、何も公開できません。
GET /connect/...は403 claim_requiredを返します。- アップロードは最大10件です。
- 受け取られないまま登録から7日が過ぎると、ワークスペースとそのキーは削除されます。
メールが見つからない場合
Section titled “メールが見つからない場合”あなたのキーで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日間の期限は延長されません。
取り消すとどうなりますか?
あなたのキーはすぐに使えなくなります。ワークスペースは人間のユーザーのもとに残り、新しいキーを作成できます。