Overview
Retrieves the list of devices currently bound to a specified user.
API Reference
- Method
GET - Path
/apigateway/binddevices/query
Request
Authentication: This API validates request headers. See Authentication.
Request Parameters
| Parameter | Data Type | Required | Description | |
|---|---|---|---|---|
| user_id | string | Yes | User ID. Maximum length: 32 characters. |
Request Example
GET /apigateway/binddevices/query?user_id=u_1001 HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
Response Example
{
"code": 0,
"data": {
"items": [
{
"user_id": "u_1001",
"device_id": "device_001",
"platform": "iOS",
"device_company": "Apple",
"device_model": "iPhone 15",
"created_time": 1713600000000
}
]
}
}
Response Parameters
| Parameter | Data Type | Required | Description | |
|---|---|---|---|---|
| items | array\<object> | Yes | Device list. | |
| items[].user_id | string | Yes | User ID. | |
| items[].device_id | string | Yes | Device ID. | |
| items[].platform | string | No | Platform identifier. | |
| items[].device_company | string | No | Device manufacturer. | |
| items[].device_model | string | No | Device model. | |
| items[].created_time | int64 | Yes | Binding time as a timestamp in milliseconds. |