← API 參考
渠道方對比

LINE 接入授權

LINE 僅支援 qrcode 登入。QR URL 與 PIN 透過 webhook 非同步下發，並快取在 GET /auth 的 auth_payload。

qrcode

LINE QR 登入：QR URL 與 PIN 非同步到達。監聽 account.auth.required，或以 GET /auth 讀取快取的 auth_payload，同時輪詢 POST /auth/qr/check。

  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. 等待 account.auth.required。平台也會快取 auth_payload.url 與 auth_payload.pin，可透過 GET /v1/accounts/{account_id}/auth 讀取。
  4. 4. 顯示 GET /v1/accounts/{account_id}/auth 回傳的 QR URL 與 PIN，同時輪詢 POST /v1/accounts/{account_id}/auth/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 稍後由 account.auth.required 下發，並快取於 GET /auth。以 POST /auth/qr/check 輪詢結果；/auth/session 僅支援 POST 匯入 session。
  • PIN 只給前端顯示，不會回傳給 LINE。把它顯示在 QR 旁讓使用者確認掃描的是哪一台裝置。
  • account.auth.succeeded 到達後 provider_account_ref 會被自動填好，事件中還會帶上標準 profile 欄位（display_name、picture_url、region、status_message）。