← API 參考
渠道方對比

LINE 接入授權

LINE 僅支援 qrcode 登入。QR URL 與 PIN 不會同步回傳，而是透過 webhook 非同步下發，再由 session 資源暴露給呼叫端。

qrcode

LINE QR 登入：QR URL 與 PIN 非同步到達。監聽 webhook 的 account.auth.required 事件，或者輪詢 /auth/session 讀 auth_payload.url（QR 圖）與 auth_payload.pin。

  1. 1. POST /v1/accounts，provider=line、auth_mode=qrcode；可選傳 metadata.device_login_type（例如 DESKTOPMAC）。
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start，請 LINE provider 開始登入會話。
  3. 3. 等待 webhook 的 account.auth.required 事件。平台同時會把 auth_payload.url（QR 圖）與 auth_payload.pin 快取在帳號上，可透過 /auth/session 同步讀到。
  4. 4. GET /v1/accounts/{account_id}/auth/session 取出 QR URL 與 PIN 顯示，同時輪詢 qr/check。
  5. 5. account.auth.succeeded 到達後 provider_account_ref 會被自動填好，呼叫 POST /v1/accounts/{account_id}/runtime/start 讓帳號上線。
  • metadata.device_login_type — 可選的裝置識別字串，例如 DESKTOPMAC、DESKTOPWIN，會原樣傳給 LINE provider 用於建立 QR 會話。

備註

  • QR URL 與 PIN 不會在 qr/start 回應中回傳，而是稍後以 account.auth.required webhook 事件非同步下發。請 GET /auth/session 或於 webhook 中取得。
  • PIN 只給前端顯示，不會回傳給 LINE。把它顯示在 QR 旁讓使用者確認掃描的是哪一台裝置。
  • account.auth.succeeded 到達後 provider_account_ref 會被自動填好，事件中還會帶上標準 profile 欄位（display_name、picture_url、region、status_message）。