功能说明
用于查询指定用户当前已绑定的设备列表。
接口说明
- Method：
GET - Path：
/apigateway/binddevices/query
请求说明
请求鉴权：接口需要校验 Header，请查看 鉴权说明
请求参数
| 参数 | 数据类型 | 是否必填 | 参数说明 | |
|---|---|---|---|---|
| user_id | string | 是 | 用户 id；最多 32 个字符 |
请求示例
GET /apigateway/binddevices/query?user_id=u_1001 HTTP/1.1
appkey: appkey
signature: 2e639ae3600a4sdff61fb88b76f485b
nonce: nonce
timestamp: 1672568121910
响应示例
{
"code": 0,
"data": {
"items": [
{
"user_id": "u_1001",
"device_id": "device_001",
"platform": "iOS",
"device_company": "Apple",
"device_model": "iPhone 15",
"created_time": 1713600000000
}
]
}
}
响应参数
| 参数 | 数据类型 | 是否必填 | 参数说明 | |
|---|---|---|---|---|
| items | array\<object> | 是 | 设备列表 | |
| items[].user_id | string | 是 | 用户 id | |
| items[].device_id | string | 是 | 设备 id | |
| items[].platform | string | 否 | 平台标识 | |
| items[].device_company | string | 否 | 设备厂商 | |
| items[].device_model | string | 否 | 设备型号 | |
| items[].created_time | int64 | 是 | 绑定时间（毫秒时间戳） |