Telegram 接入授權

驗證碼流程：平台發起驗證碼請求，使用者經由 SMS 或 App 內收到後回傳。

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. 若帳號啟用二階段驗證，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 Code 流程：取得 QR token，請使用者於 Telegram App 內掃碼。

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 token。
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 以字串成對提供。

會話匯入流程：將既有授權會話匯入 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 或參考。