Onboard a user device
POST/api/gateway/v1/mpass/users/:userId/devices/:requestId/code
Onboard a user device with qr code generated from gateway API, which doesn't require user to submit verfication code on UI
Request
Path Parameters
userId stringrequired
User ID
requestId stringrequired
Onboarding request ID
- application/json
Body
required
deviceName stringrequired
Device name
deviceToken stringrequired
Device token
publicKey stringrequired
Device public key
Responses
- 200
- 404
Device onboarded successfully
- application/json
- Schema
- Example (from schema)
Schema
status numberrequired
Response status code
message stringrequired
Response status message
data
object
required
Response data
userId stringrequired
User ID
deviceId stringrequired
Device ID
status stringrequired
Possible values: [active
, inactive
]
Device status
userCode stringrequired
User code
deviceCode stringrequired
Device code
tokenEndpoint stringrequired
Token endpoint, mobile app will poll this endpoint to get the token
interval numberrequired
Interval, mobile app will poll the token endpoint every interval milliseconds
requestId string
Request ID for tracking
{
"status": 200,
"message": "OK",
"data": {
"userId": "550e8400-e29b-41d4-a716-446655440000",
"deviceId": "device-123",
"status": "active",
"userCode": "123456",
"deviceCode": "123456",
"tokenEndpoint": "string",
"interval": 1000
},
"requestId": "req-123456"
}
User not found
Loading...