GET /connect/{platform}
オーナーがブラウザで開くためのURLを返します。オーナーがそのURLでSNSにログインすると、アカウントが/accountsに表示されます。MCPツール：get_connect_url。
curl "https://botdoor.co/api/v1/connect/instagram" -H "Authorization: Bearer $BOTDOOR_KEY"| クエリ | 備考 |
|---|---|
redirect_url |
完了後の遷移先。デフォルトはhttps://botdoor.co/accounts。botdoor.co上のURLである必要があります |
reconnect |
既存アカウントを更新する場合、そのアカウントのzernioAccountId |
レスポンス 200
Section titled “レスポンス 200”{"platform": "instagram", "url": "https://…", "redirectUrl": "https://botdoor.co/accounts", "hint": "Open this URL in a browser as the account owner. It expires in about an hour. Afterwards GET /api/v1/accounts lists the new account."}| ステータス | コード | 意味 |
|---|---|---|
| 400 | platform_not_supported |
不明なプラットフォーム名 |
| 400 | platform_coming_soon / platform_unavailable |
まだ連携できない |
| 400 | connect_requires_human |
BlueskyはURLではなく、アプリで入力するアプリパスワードを使う |
| 400 | invalid_redirect |
redirect_urlがbotdoor.co上にない |
| 403 | claim_required |
ワークスペースがまだ受け取られていない |
| 403 | plan_limit_reached |
プランのアカウント数の上限に達した |
| 403 | plan_feature_unavailable |
X（Twitter）にはSoloまたはAgencyが必要 |
| 404 | account_not_found |
reconnectが、このワークスペースにあるそのSNSのアカウントのzernioAccountIdではない |
| 502/503 | upstream_* |
投稿プロバイダーで問題が発生している。後で再試行してください |
よくある質問
URLの有効期間はどのくらいですか？
約1時間です。期限が切れたら新しいURLを取得してください。
同じSNSのアカウントを2つ連携できますか？
はい。プランのアカウント数の上限まで連携できます。もう一度connectを呼び出し、別のアカウントでログインしてください。
Blueskyでconnect_requires_humanが返るのはなぜですか？
Blueskyは、アプリの「アカウント」ページでハンドルとアプリパスワードを入力して連携します。そのため、渡せるURLがありません。