Generate a new QR Code

Generate a new QR Code for pairing authentication between two devices.

post

This endpoint is called by the initiating device (Admin or Client) to start the pairing process. The generated QR Code contains a link with pairing session ID as a parameter.

Example Flow:

1. Device A calls this endpoint to get QR Code data.
2. Device B scans the QR Code and calls POST api/v1/users/auth/passwordless/qrcode/:qrCodeId/approve to approve.

Query parameters

callbackUrlstringOptional

Optional URL for the QR Code link. If provided, the QR Code will encode this URL with a query id for the pairing session.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Responses

200

The request was successful.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/users/auth/passwordless/qrcode/generate HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Accept: */*

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAl4AAAJeAQAAAABNW...",
    "id": "0aa75c7e-478c-442d-a828-57387a6bc94f",
    "status": "New",
    "approvedAt": null
  },
  "errors": []
}