Generate a new OTP code

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

post

Similar to QR Code pairing but uses a numeric or alphanumeric code instead. The OTP Code should have a short TTL (e.g., 60 seconds).

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

The API result model with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Required

This is the message to be displayed to the user.

429

API call exceeded rate limit due to too many requests.

application/json

post

/api/v1/users/auth/passwordless/otp/generate

HTTPcURLJavaScriptPython

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

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "code": "123456",
    "expiryDate": "0001-01-01T00:00:00",
    "id": "9b9091a2-fcee-429d-93ec-b81d1efe7f6f",
    "status": "New",
    "approvedAt": null
  },
  "errors": []
}