更新时间：2024-05-21 GMT+08:00
批量查询版本能力集
功能介绍
批量查询版本能力集
URI
POST /v1/{user_id}/devices/ability
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
user_id |
是 |
String |
用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Access-Token |
是 |
String |
用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
versions |
是 |
Array of versions objects |
设备版本 |
need_specification |
否 |
Boolean |
是否需要返回具体规格，不传默认false |
ability |
否 |
Array of strings |
查询的云上能力集列表，不传默认查询所有能力集 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
device_type |
是 |
String |
设备类型，必填，可以通过用户根据设备ID查询设备信息详情获取 |
firmware |
是 |
String |
设备软件版本，必填，可以通过用户根据设备ID查询设备信息详情获取 |
model |
是 |
String |
设备固件类型（设备款型），必填，可以通过用户根据设备ID查询设备信息详情获取 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
abilities |
Array of DeviceVersionAndAbilities objects |
设备版本对应能力集返回体 |
请求示例
通过版本查询设备能力集
POST /v1/2562572829***/devices/ability
{
"versions" : [ {
"device_type" : "IPC",
"model" : "C3050-10-LI-PV(3.6mm)",
"firmware" : "SDC 10.0.RC11"
}, {
"device_type" : "IPC",
"model" : "C3050-10-LI-PV(3.6mm)",
"firmware" : "SDC 10.0.RC12"
} ],
"need_specification" : true,
"ability" : [ "ptz", "soundlightalarm" ]
}
响应示例
状态码： 200
OK
{
"abilities" : [ {
"device_type" : "IPC",
"firmware" : "SDC 10.0.RC11",
"model" : "C3050-10-LI-PV(3.6mm)",
"abilities" : {
"ptz" : {
"support" : false
},
"soundlightalarm" : {
"alarm_voice_file_max_num" : "6",
"alarm_voice_one_file_max_size" : "76800",
"alarm_voice_file_max_size" : "524288",
"support" : false
}
}
}, {
"device_type" : "IPC",
"firmware" : "SDC 10.0.RC12",
"model" : "C3050-10-LI-PV(3.6mm)",
"abilities" : {
"ptz" : {
"support" : false
},
"soundlightalarm" : {
"support" : false
}
}
} ]
}
状态码
请参见状态码
错误码
请参见错误码
父主题： 云上能力集管理
