Skip to content

QR Code Login

Cross-device authentication similar to WhatsApp Web.

How It Works

  1. Desktop app shows QR code
  2. Mobile app scans QR code
  3. User approves on mobile
  4. Desktop app gets authenticated

Generate QR Code

curl -X POST http://localhost:8000/api/sso/v1/auth/qr/generate

Returns session ID and QR code data.

Poll for Status

curl -X GET http://localhost:8000/api/sso/v1/auth/qr/status/SESSION_ID

Approve on Mobile

curl -X POST http://localhost:8000/api/sso/v1/auth/qr/approve \
  -H "Authorization: Bearer MOBILE_TOKEN" \
  -d '{"session_id": "SESSION_ID"}'