已激活设备操作API
更新时间：2026-04-30
激活设备信息查询接口
接口描述
本接口用于查询用户自己名下特定licenseId和appId下的设备激活信息。
权限说明
该API的安全认证一律采用Access Key与请求签名机制。 鉴权认证机制的详细内容请参见 鉴权认证。
注意事项
请求结构
Plain Text
1POST /v{version}/aiagent/api/device/list 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将无效 |
| ++userId | string | 否 | 用户Id（设备激活时用户传递的userId），在uuid为空时可以生效 |
| ++deviceId | string | 否 | 设备Id，在userId生效时可以设置（需要传递非打码的完整值）。设备Id通常由SDK自动获取，用户无感，故不建议设置 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| 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 https://rtc-aiagent.baidubce.com/v2/aiagent/api/device/list
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}设备增值服务扩展接口
接口描述
本接口用于通过用量包为指定设备扩展增值服务。通过 uuid 或 licenseId + appId + userId 的组合唯一定位一条激活记录，将用量包中包含的增值服务绑定到该设备上。
权限说明
该API的安全认证一律采用Access Key与请求签名机制。 鉴权认证机制的详细内容请参见 鉴权认证。
注意事项
-
定位激活记录支持两种方式，二者互斥：
- 方式一：提供
uuid（激活记录ID），优先级更高； - 方式二：同时提供
appId和userId。
- 方式一：提供
- 若激活记录已过期，接口将返回错误，无法扩展增值服务。
- 若用量包中包含的增值服务已存在于该设备，则该服务不会重复绑定，接口仍正常返回。
请求结构
Plain Text
1POST /v{version}/aiagent/api/device/extend HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>
5
6{
7 "licenseId": "",
8 "appId": "",
9 "userId": "",
10 "uuid": "",
11 "packageIds": ["", ""]
12}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| licenseId | string | 条件必选 | 许可证ID。当 uuid 为空时，需与 userId appId 同时提供以定位激活记录 |
| appId | string | 条件必选 | 应用ID。当 uuid 为空时，需与 userId licenseId 同时提供以定位激活记录 |
| userId | string | 条件必选 | 客户侧用户唯一标识。当 uuid 为空时，需与 appId licenseId 同时提供以定位激活记录 |
| uuid | string | 条件必选 | 激活记录ID。优先使用此字段定位激活记录；提供后 appId 和 userId 不再生效 |
| packageIds | array | 是 | 用量包ID列表，不能为空 |
| + | string | 用量包ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | string | 操作结果，成功时返回 SUCCESS |
| usedPackageIds | array | 本次实际使用的用量包ID列表（仅包含成功新增了增值服务的用量包） |
| + | string | |
| allValueServices | array | 本次扩展后，该设备拥有的全部新增增值服务列表 |
| + | string |
错误码
| 错误码 | HTTP 状态码 | 描述 |
|---|---|---|
| ActivationNotExist | 404 | 未查询到激活记录，请确认 uuid 或 appId + userId 是否正确 |
| ActivationAlreadyExpired | 400 | 激活记录已过期，无法扩展增值服务 |
请求示例
Plain Text
1POST https://rtc-aiagent.baidubce.com/v2/aiagent/api/device/extend
2Host: rtc-aiagent.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "licenseId": "AAAAAAA",
6 "appId": "BBBB",
7 "userId": "12345678",
8 "uuid": "CCCC",
9 "packageIds": ["pkg-001", "pkg-002"]
10}响应示例
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 "result": "SUCCESS",
8 "usedPackageIds": ["pkg-001"],
9 "allValueServices": ["SERVICE_A", "SERVICE_B"]
10}评价此篇文章