Telegram 認証

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

1. 1. POST /v1/accounts に provider=telegram、auth_mode=code、provider_data.phone を指定します。provider_data の api_id と api_hash は任意で、省略するとプラットフォームのデフォルトのアプリ認証情報が使用されます。
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. 認証成功後はまず runtime_status を確認してください。起動がまだ必要な場合にのみ POST /v1/accounts/{account_id}/runtime/start を呼び出します。

• provider_data.api_id — 任意。my.telegram.org で取得した Telegram App ID。省略するとプラットフォームのデフォルトのアプリ認証情報が使用されます。独自のアプリを使う場合は、同じアプリの api_id と api_hash を両方とも文字列で指定してください。
• provider_data.api_hash — 任意。my.telegram.org で取得した Telegram App Hash。省略するとプラットフォームのデフォルトのアプリ認証情報が使用されます。独自のアプリを使う場合は、同じアプリの api_id と api_hash を両方とも文字列で指定してください。
• 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. 認証成功後はまず runtime_status を確認してください。起動がまだ必要な場合にのみ POST /v1/accounts/{account_id}/runtime/start を呼び出します。

• provider_data.api_id — 任意。my.telegram.org で取得した Telegram App ID。省略するとプラットフォームのデフォルトのアプリ認証情報が使用されます。独自のアプリを使う場合は、同じアプリの api_id と api_hash を両方とも文字列で指定してください。
• provider_data.api_hash — 任意。my.telegram.org で取得した Telegram App Hash。省略するとプラットフォームのデフォルトのアプリ認証情報が使用されます。独自のアプリを使う場合は、同じアプリの api_id と api_hash を両方とも文字列で指定してください。

セッション取り込みフロー：既に認証済みの 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. 認証成功後はまず runtime_status を確認してください。起動がまだ必要な場合にのみ POST /v1/accounts/{account_id}/runtime/start を呼び出します。

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