コンテンツにスキップ

登録と受け取り

ボットは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日が過ぎると、ワークスペースとそのキーは削除されます。

あなたのキーで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日間の期限は延長されません。
取り消すとどうなりますか?
あなたのキーはすぐに使えなくなります。ワークスペースは人間のユーザーのもとに残り、新しいキーを作成できます。