激活设备查询API
更新时间：2026-03-05
激活设备信息查询接口
接口描述
本接口用于查询用户自己名下特定licenseId和appId下的设备激活信息。
权限说明
该API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成，均为字符串。 对于每个HTTP请求，使用下面所描述的算法生成一个认证字符串。提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}。
- version是正整数。
- timestamp是生成签名时的UTC时间。
- expirationPeriodInSeconds表示签名有效期限。
- signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号（;）分隔，如host;x-bce-date。列表按照字典序排列。（本API签名仅使用host和x-bce-date两个header）
- signature是256位签名的十六进制表示，由64个小写字母组成。
当百度智能云接收到用户的请求后，系统将使用相同的SK和同样的认证机制生成认证字符串，并与用户请求中包含的认证字符串进行比对。如果认证字符串相同，系统认为用户拥有指定的操作权限，并执行相关操作；如果认证字符串不同，系统将忽略该操作并返回错误码。
鉴权认证机制的详细内容请参见 鉴权认证。
注意事项
请求结构
Plain Text
1POST /v{version}/aiagent/api/device HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>
5
6{
7 "pageNo": 1,
8 "pageSize": 10,
9 "licenseId": "",
10 "appId": "",
11 "startTime":"",
12 "endTime":"",
13 "devices": [
14 {
15 "uuid": "",
16 "deviceId": "",
17 "userId": ""
18 }
19 ]
20}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| pageNo | integer | 否 | 页面编号，默认值为1 |
| pageSize | integer | 否 | 页面大小，默认值为10，最大值为1000 |
| licenseId | string | 是 | 许可证ID |
| appId | string | 是 | 应用ID |
| startTime | date | 否 | 起始时间（UTC时间，通过激活时间过滤） |
| endTime | date | 否 | 结束时间（UTC时间，通过激活时间过滤） |
| devices | array | 否 | 设备列表 |
| + | object | ||
| ++uuid | string | 否 | 激活记录ID，填写此项后，deviceId和userId将无效 |
| ++deviceId | string | 否 | 设备ID，在uuid为空时生效 |
| ++userId | string | 否 | 设备唯一标识，在deviceId生效时，可以设置 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| pageNo | integer | 页面编号 |
| pageSize | integer | 页面大小 |
| totalCount | integer | 总记录数 |
| data | array | 激活信息列表 |
| + | object | |
| ++uuid | string | 激活记录ID |
| ++deviceId | string | 加密后的设备ID （加密方式：deviceId中间50%信息将被加密，至少一个字符被加密。总字符串数与原数据保持一致。） |
| ++userId | string | 客户侧唯一标识 |
| ++activationTime | string | 激活时间(UTC) |
| ++expirationTime | string | 过期时间(UTC)，注：2037-12-31 之后的时间表示永久 |
| ++status | string | 设备状态，VALID表示生效中，FORBIDDEN表示已禁用，INVALID表示无效 |
请求示例
Plain Text
1POST http:// rtc-aiagent.baidubce.com/v2/aiagent/api/device
2Host: rtc-aiagent.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4 {
5 "pageNo": 1,
6 "pageSize": 10,
7 "licenseId": "AAAAAAA",
8 "appId": "BBBB",
9 "startTime":"2026-02-16T06:32:14Z",
10 "endTime":"2027-12-16T06:32:14Z",
11 "devices": [
12 {
13 "uuid": "CCCC",
14 "deviceId": "",
15 "userId": ""
16 },
17 {
18 "uuid": "",
19 "deviceId": "DDDD",
20 "userId": ""
21 }
22 ]
23 }响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "pageNo": 1,
8 "pageSize": 10,
9 "totalCount": 1,
10 "data":[
11 {
12 "uuid": "CCCCC",
13 "deviceId": "a4:6e:83",
14 "userId": "12345678",
15 "activationTime": "2025-12-16T06:32:14Z",
16 "expirationTime": "2038-01-01T00:00:00Z",
17 "status": "VALID"
18 }
19 ]
20}