← 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 プロバイダに QR セッションを開始させる。
  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 などの任意のデバイス識別子。QR セッション開始時に LINE プロバイダへそのまま渡されます。

注記

  • 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) も含まれます。