Request Device Pairing API

Send a device pairing request. After calling this API, the device will announce a 4-digit OTP code.


API Endpoint

POST
https://speaker-api.sepay.vn/devices/v1/speaker/pair/request

Request Parameters

hardwareIdstringrequired

Device serial number

Note
  • After calling this API, the system will send a 4-digit OTP code to the device
  • The device will announce the OTP code aloud
  • User enters the OTP to verify
  • Session ID is valid for approximately 2 minutes

Code Examples

1
2
3
4
5
curl --request POST \
--url https://speaker-api.sepay.vn/devices/v1/speaker/pair/request \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/json' \
--data '{"hardwareId":"VNS52508000001"}'

API Response

Response 200 - Success
{
  "code": 200,
  "message": "Thành công",
  "data": {
    "hardwareId": "VNS52508000001",
    "model": "S5 Plus",
    "isPaired": false,
    "session_id": "8b9f6d2a-3c1b-4f7a-a7d4-123456789abc",
    "online": true
  }
}
codeinteger

Response code

messagestring

Result description

dataobject