← API リファレンス
プロバイダ比較

LINE 認証

LINE は qrcode ログインのみ対応。QR URL と PIN は webhook で非同期に届き、GET /auth の auth_payload にキャッシュされます。

qrcode

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

注記

  • QR URL と PIN は account.auth.required で届き GET /auth にキャッシュされます。結果は POST /auth/qr/check で確認し、/auth/session は POST の session import 専用です。
  • PIN は表示用で、LINE へ送り返すものではありません。QR の隣に表示してユーザーに対象デバイスを確認してもらってください。
  • account.auth.succeeded 受信時に provider_account_ref が自動で埋まります。イベントには標準 profile フィールド (display_name、picture_url、region、status_message) も含まれます。