# GET /connect/{platform}

> オーナーがSNSアカウントをBotdoorに連携または再連携するための、1時間有効なブラウザ用URLを取得します。

Source: https://docs.botdoor.co/ja/api/connect/

オーナーがブラウザで開くためのURLを返します。オーナーがそのURLでSNSにログインすると、アカウントが[/accounts](https://docs.botdoor.co/ja/api/accounts/)に表示されます。MCPツール：`get_connect_url`。

```bash
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`

```json
{"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がありません。