Telegram 認証

認証コードフロー：サーバーが Telegram にコードを要求し、ユーザーが SMS またはアプリ内で受け取って送信し直します。

1. 1. POST /v1/accounts に provider=telegram、auth_mode=code、provider_data に api_id / api_hash / phone を入れて送信。
2. 2. POST /v1/accounts/{account_id}/auth/start で Telegram に認証コードを送らせる。
3. 3. ユーザーが受け取ったコードを POST /v1/accounts/{account_id}/auth/code で送信。
4. 4. 2FA が有効な場合は status=awaiting_password が返るので、POST /v1/accounts/{account_id}/auth/password でパスワードを送信。
5. 5. 成功したら POST /v1/accounts/{account_id}/runtime/start でアカウントをオンライン化。

• provider_data.api_id — my.telegram.org で取得した Telegram App ID。Telegram の 3 フローで必須。
• provider_data.api_hash — my.telegram.org で取得した Telegram App Hash。Telegram の 3 フローで必須。
• provider_data.phone — E.164 形式の電話番号。code フローでのみ必要。

QR コードフロー：QR トークンを取得し、ユーザーに Telegram アプリで読み取らせます。

1. 1. POST /v1/accounts に provider=telegram、auth_mode=qrcode、provider_data.api_id / api_hash を指定。
2. 2. POST /v1/accounts/{account_id}/auth/qr/start を呼ぶと、表示用の QR トークンが返る。
3. 3. POST /v1/accounts/{account_id}/auth/qr/check を status=authorized になるまでポーリング。QR は約 30 秒で失効するので、その都度 qr/start を再実行。
4. 4. 成功したら POST /v1/accounts/{account_id}/runtime/start。

• provider_data.api_id — my.telegram.org で取得した Telegram App ID。Telegram の 3 フローで必須。
• provider_data.api_hash — my.telegram.org で取得した Telegram App Hash。Telegram の 3 フローで必須。

セッション取り込みフロー：既に認証済みの Telegram アカウントを UnifyPort に取り込みます。

1. 1. POST /v1/accounts に provider=telegram、auth_mode=session を指定。
2. 2. POST /v1/accounts/{account_id}/auth/session に params.session_url を渡し、ダウンロード可能な .session ファイルを指す。
3. 3. インポートのレスポンスでセッションの有効性を確認したら、POST /v1/accounts/{account_id}/runtime/start。

• params.session_url — 既存の Telegram セッションの URL または参照。