华为云用户手册

云台控制 接口 说明 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 获取云台控制权 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 释放云台控制权 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/ptz/angle-spin 云台点动转动

设备组管理 接口 说明 GET /v1/{user_id}/device-orgs/{device_org_id}/sub-orgs 查询子级设备组织 GET /v1/{user_id}/device-orgs/{device_org_id}/devices 查询企业下的组织的设备列表 PUT /v1/{user_id}/device-orgs/{device_org_id} 修改设备分组名称 POST /v1/{user_id}/device-orgs 添加设备分组 DELETE /v1/{user_id}/device-orgs/{device_org_id} 删除单个设备组 POST /v1/{user_id}/device-orgs/{device_org_id}/move-devices 移动多个设备到新的设备组 GET /v1/{user_id}/device-orgs/tree 根据设备组名称查询设备组织树(支持设备组名称模糊查询)

设备管理 接口 说明 GET /v1/{user_id}/devices/{device_id} 用户根据设备ID查询设备信息详情 GET /v1/{user_id}/devices 用户查询设备列表 GET /v1/{user_id}/devices/{device_id}/gateway 查询设备网关（仅支持国标） PUT /v1/{user_id}/devices/{device_id} 修改设备信息 PUT /v1/{user_id}/devices/{device_id}/gb-account 修改国标设备账号 POST /v1/{user_id}/devices/holosens 添加好望设备 POST /v1/{user_id}/devices/gb/batch-add 批量添加国标设备 POST /v1/{user_id}/devices/batch-delete 批量删除设备

URI GET /v1/{user_id}/devices/snap 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 表2 Query参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 storage 是 String 是否 云存储 标识。 枚举值： true 当需要云存储时，接口返回图片的下载URL； false 无需存储时，返回图片base64编码数据。

响应示例 状态码： 200 OK 示例 1 { "pic_url" : "// 当 storage 字段为 false 时，此字段为空串", "pic_data" : "AAAAgAAAAAAAAAAAAAAAgAAAAd+/G0N4rYLasJ08oixRKANqyPxtwopjAcfLZ4vrF3LjwAAAAAAAAAAAAAAsIovJNbDeBeddTigN037AAiOm67Mrvka1Ht8LGT2S8FDAySkfqvCnq+ CS 5BmInek3OfrSDIQDy+TUImvmwYXjpj3FkYIU+L0GkGD7C6r73YxoZ2ocChqpARrXIzlp/zKi4DpzQ47Ese4IX2zkrLgehpMhE98" } 示例 2 { "pic_url" : "http://api-ivm.myhuaweicloud.com/v1/holo/219123456CYP***_0_210/static", "pic_data" : "// 当 storage 字段为 true 时，此字段为空串" } 示例2中获取到的pic_url的请求示例如下 请求 http://api-ivm.myhuaweicloud.com/v1/holo/219123456CYP***_0_210/static Access-Token: xxx 响应格式1: { "pic_data": "ABCD1234ABCD1234ABCD1234ABCD1234ABCD1234ABCD1234ABCD1234ABCD1234" // base64编码的图片 } 响应格式2: 二进制编码的图片内容

请求示例 批量设置通道录像计划 PUT /v1/2562572829***/devices/channels/record-plan { "plans" : [ { "device_id" : "952352LWXT***", "channel_id" : "0", "all_day" : false, "time_sections" : [ { "day_of_week" : 1, "start_time" : "00:02:00", "end_time" : "00:05:00" }, { "day_of_week" : 1, "start_time" : "00:06:00", "end_time" : "00:08:00" }, { "day_of_week" : 2, "start_time" : "00:02:00", "end_time" : "00:05:00" } ] }, { "device_id" : "952352DJNR***", "channel_id" : "0", "all_day" : false, "time_sections" : [ { "day_of_week" : 1, "start_time" : "00:02:00", "end_time" : "00:05:00" } ] } ] }

响应示例 状态码： 200 OK { "failed_num" : 0, "channels" : [ { "device_id" : "952352LWXT***", "channel_id" : "0", "result" : { "code" : "IVM.0", "msg" : "Success" } }, { "device_id" : "952352DJNR***", "channel_id" : "0", "result" : { "code" : "IVM.0", "msg" : "Success" } } ] }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 failed_num Integer 失败数量 channels Array of ChannelResult objects 通道结果 表7 ChannelResult 参数 参数类型 描述 device_id String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 result Result object 结果信息 表8 Result 参数 参数类型 描述 code String 错误编码 msg String 错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 plans 是 Array of ChannelBindRecordPlan objects 通道设置录像计划 record_type 否 String 录像类型：枚举类型，默认为NORMAL_RECORD。 枚举值： NORMAL_RECORD 标准连续云存 表4 ChannelBindRecordPlan 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 all_day 否 Boolean 是否全程录像：枚举类型，默认为false。如果为true，time_sections省略 枚举值： true 是 false 否 time_sections 否 Array of TimeSection objects 通道录像计划时间段：取值范围[1,+∞)。如果all_day字段为空或为false，则字段必填 表5 TimeSection 参数 是否必选 参数类型 描述 day_of_week 是 Integer 日期：取值范围[1,7]（对应周一~周日） start_time 是 String 录像开始时间：格式为HH:mm:ss，范围为[00:00:00~23:59:59] end_time 是 String 录像结束时间：格式为HH:mm:ss，范围为[00:00:00~23:59:59]

响应示例 状态码： 200 查询设备录像列表响应 { "total": 6, "device_id": "219123456CYP***", "channel_id": "0", "records": [ { "record_id": "12346556", "record_name": "_0_0_.rf", "record_type": "NORMAL_RECORD", "storage_state": 0, "record_size": 340017, "start_time": "2023-03-20 09:30:00", "end_time": "2023-03-20 09:44:39", "alarm_rec_type": [] }, { "record_id": "12346557", "record_name": "_0_1_.rf", "record_type": "NORMAL_RECORD", "storage_state": 0, "record_size": 340017, "start_time": "2023-03-20 09:46:41", "end_time": "2023-03-20 10:56:50", "alarm_rec_type": [] } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 录像文件总数量 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] records Array of ListDeviceRecordFilesResp objects 录像列表 表5 ListDeviceRecordFilesResp 参数 参数类型 描述 record_id String 录像ID：长度范围[1,32]，仅云端回放列表返回 record_name String 录像文件名称：长度范围[1,32] record_type String 录像类型：枚举类型 枚举值： NORMAL_RECORD 全量： 录像计划产生的录像 MOTION_RECORD 动检： 移动侦测产生的录像 AL RAM _RECORD 告警： 智能分析，目标分析等告警输入产生的录像 storage_state Integer 该接口返回参数新增storage_state（存储状态）枚举类型 枚举值 0 热备 标准存储 1 归档 2 回热中 归档（恢复中） 3 冷备 标准存储 record_size Integer 录像文件大小：单位（字节），仅云端回放列表返回 start_time String 录像开始时间：格式：yyyy-MM-dd HH:mm:ss end_time String 录像结束时间：格式：yyyy-MM-dd HH:mm:ss alarm_rec_type Array of string 告警录像类型：枚举类型，非告警录像值为空（null）

请求示例 查询前端的录像列表 GET /v2/123456789*****/devices/219123456CYP***/channels/0/media/records?start_time=2023-03-20 09:30:00&end_time=2023-03-20 19:30:00&limit=2&record_type=NORMAL_RECORD&record_position=CLOUD

URI GET /v2/{user_id}/devices/{device_id}/channels/{channel_id}/media/records 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 开始时间：格式如：yyyy-MM-dd HHmmss end_time 是 String 结束时间：格式如：yyyy-MM-dd HHmmss record_position 是 String 录像位置，枚举类型 枚举值： CLOUD 云端录像 DEVICE 前端录像 record_type 否 String 录像类型：枚举类型，仅针对查询云端录像，不填则默认值为 ALL_RECORD 枚举值： ALL_RECORD 所有录像 NORMAL_RECORD 全量录像 MOTION_RECORD 动检录像 limit 否 String 单页数量：取值范围[1,1000]，不填写时默认值为 10 offset 否 String 偏移量：offset为0时表示查询第一页的数据，取值范围[0,1000000]，不填写时默认值为 0 alarm_rec_type 否 String 告警录像种类（非告警录像值为null）

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/device-records/playback-url 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID： 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 开始时间：格式如：yyyy-MM-dd HH:mm:ss end_time 是 String 结束时间：格式如：yyyy-MM-dd HH:mm:ss playback_protocol 否 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型，不填写时默认值为 HOLO 枚举值： HOLO 好望协议 expire_time 否 String 自定义Url过期时间：时间范围[30, 86400]，不传默认为 30（单位/秒） 备注：仅对响应Body参数中的playback_url有效 use_times 否 String 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0 备注：仅对响应Body参数中的playback_url有效 枚举值： 0 使用一次 1 有效时间内任意使用 trans_protocol 否 String 传输协议：枚举类型，不填写时默认值为 TCP，仅适用于gb28181，其它接入协议无效 枚举值： TCP TCP传输协议 UDP UDP传输协议 stream_type 否 String 码流类型：枚举类型，不填写时默认值为 PRIMARY_STREAM 枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2

响应示例 状态码： 200 OK { "total" : 1, "device_id" : "952352LWXT***", "channel_id" : "0", "records" : [ { "record_id" : "1000000", "start_time" : "2020-06-12 17:31:00", "end_time" : "2020-06-13 12:50:00", "record_name" : "录像1", "record_size" : 1024, "record_type" : "NORMAL_RECORD" } ] }

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 end_time 是 String 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 limit 否 Integer 单页数量：取值范围[1,1000]，不填写时默认值为 10 offset 否 Integer 偏移量：offset为0时表示查询第一页的数据，取值范围[0,1000000]，不填写时默认为 0 record_type 否 String 录像类型：枚举类型，不填则默认包含以下两种录像类型 枚举值： NORMAL_RECORD 全量录像 MOTION_RECORD 动检录像

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 录像列表总数 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] records Array of Record objects 录像列表信息 表5 Record 参数 参数类型 描述 record_id String 录像ID：长度范围[1,32] record_name String 录像名称：长度范围[1,32] record_type String 录像类型：枚举类型 枚举值： NORMAL_RECORD 全量录像 MOTION_RECORD 动检录像 record_size Integer 录像文件大小：单位（字节） alarm_rec_type String 告警录像类型：枚举类型，非告警录像值为空（null） start_time String 录像开始时间：格式如：yyyy-MM-dd HH:mm:ss，2020-06-12 17:31:00 end_time String 录像结束时间：格式如：yyyy-MM-dd HH:mm:ss，2020-06-12 17:31:00

请求示例 用户【123456781234567812345***】设备开通【MANAGE】类型按需 /v1/123456781234567812345***/devices/channels/resources { "resource_id" : "d84c8cbabb8145b390bced5f2a774af6", "storage_day" : 7, "channels" : [ { "device_id" : "1abcdef8", "channel_id" : "1" }, { "device_id" : "12345678901234******", "channel_id" : "2" } ] }

响应示例 状态码： 200 OK { "failed_num" : 0, "channels" : [ { "device_id" : "34020000001*********", "channel_id" : "34020000001*********", "result" : { "code" : "IVM.0", "msg" : "Success" } } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 resource_id 是 String 资源ID：该资源ID可从查询包周期和按需资源列表接口进行获取 storage_day 否 Float 存储天数：例如连续收录中录像的存储天数等 当resourceID为连续收录按需服务、行业数据流按需服务、动检云存储按需服务三种按需资源时必传，参数范围为[1,365]， 不传报错 当resourceID为包周期资源时不传，默认值为0， 传非0值报错 channels 是 Array of Channel objects 通道信息 表4 Channel 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 failed_num Integer 开通失败设备数 channels Array of Device objects 通道列表 表6 Device 参数 参数类型 描述 device_id String 设备ID channel_id String 通道ID result Result object 错误或成功信息 表7 Result 参数 参数类型 描述 code String 错误码 msg String 错误码描述信息

响应示例 状态码： 200 OK { "failed_num" : 0, "channels" : [ { "device_id" : "952352LWXT***", "channel_id" : "0", "result" : { "code" : "IVM.0", "msg" : "Success" } }, { "device_id" : "952352DJNR***", "channel_id" : "1", "result" : { "code" : "IVM.0", "msg" : "Success" } } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 channel_time_policies 是 Array of ChannelTimePolicy objects 设置设备通道留存期：长度范围[1,100] 表4 ChannelTimePolicy 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 time_policies 是 Array of TimePolicy objects 资源储存留存期集合：长度不可为0 表5 TimePolicy 参数 是否必选 参数类型 描述 storage_days 是 Integer (单位：天) 留存期,留存期取值范围：[1,365] storage_type 是 String 留存期类型：计划录像：PLAN_RECORD 动检录像：MOTION_RECORD 枚举值： PLAN_RECORD 计划录像 MOTION_RECORD 动检录像

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 failed_num Integer 失败数量 channels Array of ChannelResult objects 通道结果列表 表7 ChannelResult 参数 参数类型 描述 device_id String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 channel_id String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 result Result object 结果信息 表8 Result 参数 参数类型 描述 code String 错误编码 msg String 错误信息

请求示例 批量设置通道存储时间策略请求示例 PUT /v1/2562572829***/devices/channels/time-policy { "channel_time_policies" : [ { "device_id" : "952352LWXT***", "channel_id" : "0", "time_policies" : [ { "storage_days" : 15, "storage_type" : "PLAN_RECORD" }, { "storage_days" : 15, "storage_type" : "MOTION_RECORD" } ] }, { "device_id" : "952352DJNR***", "channel_id" : "1", "time_policies" : [ { "storage_days" : 15, "storage_type" : "PLAN_RECORD" } ] } ] }

智能数据（TLV）相关字段枚举值说明参考 表1 trecord_type 告警类型 告警类型枚举值 释义 告警类型枚举值 释义 告警类型枚举值 释义 告警类型枚举值 释义 0 移动侦测 16 中硬遗留检测 32 偏色诊断 48 逆行 1 遮挡检测 17 音频有无告警 33 停车侦测 49 异常车牌 2 目标检测 18 音频陡降告警 34 机非人 50 交通拥堵 3 3559目标检测 19 音频陡降告警 35 过线计数 51 倒车 4 3559目标识别 20 区域进入 36 微卡口 52 车辆黑名单设防 5 入侵检测 21 区域离开 37 ITS违章信息 53 车辆白名单设防 6 目标计数 22 快速移动 38 ITS存储图片 54 遮挡车牌 7 干扰检测 23 场景变更 39 人群密度 55 打架 8 干扰检测 24 自动跟踪 40 排队检测 56 攀爬 9 网络端口状态 25 虚焦检测 41 违停球 57 跌倒 10 中硬拌线检测 26 聚集侦测 42 交通拥堵告警 58 跑步 11 中硬入侵检测 27 抖动诊断 43 机非人_目标 59 火点告警 12 中硬徘徊检测 28 画面冻结诊断 44 违法停车 60 温控告警 13 中硬遗留检测 29 雪花噪声诊断 45 非占机 - - 14 中硬移走检测 30 条纹噪声诊断 46 机占非 - - 15 中硬干扰检测 31 亮度诊断 47 压线 - - 表2 rule_type 规则线类型 规则线类型枚举值 枚举值原型 释义 规则线类型枚举值 枚举值原型 释义 0 TRIPWIRE_RULE 拌线 13 MSL_AUTO_CALIB_RULE 枪球联动自动标定 1 WANDER_RULE 漂移 14 MSL_AUTO_CALIB_RULE_CLEAR 枪球联动自动标定清除 2 ABANDON_RULE 遗留 15 FIGHTING_RULE 打架 3 REMOVE_RULE 移走 16 CLIMBING_RULE 攀爬 4 INVASION_RULE 入侵 17 FALL_DOWN_RULE 跌倒 5 ENTER_RULE 进入 18 RUNNING_RULE 跑步 6 EXIT_RULE 退出 19 FIRE_DETECT_RULE 火点检测 7 FASTMOVE_RULE 快速移动 20 CALIB_RULE_RULE 定点 8 CARDETECTION_RULE 车辆检测 21 COMM_TLV_TEXT_RULE 通用TLV字体显示 9 HUMANCOUNT_RULE 人群计数 22 MOTORBIKE_DET_RULE 电瓶车告警 10 CROWDDENSITY_DETECT_RULE 人群密度 23 LEAVEDETECT_RULE 离岗检测 11 QUEUE_DETECT_RULE 排队检测 - - - 12 IBALL_DETECT_RULE 违停球检测 - - - 表3 plate_color 车牌颜色 车牌颜色枚举值 释义 车牌颜色枚举值 释义 1 蓝底白字 9 白底红字 2 黄底黑字 10 蓝底白字 3 白底黑字 11 白底蓝字 4 黑底白字 12 白底黄字 5 绿底白字或者绿底黑字 13 白底绿字 6 渐变绿底黑字 14 白底灰字 7 黄绿双拼底黑字 15 灰底黑字 8 红底白字 - - 表4 vehicle_type 机非人类型 机非人类型枚举值 释义 机非人类型枚举值 释义 1 轿车 22 中型SUV 2 货车 23 中大型SUV 3 面包车 24 大型SUV 4 客车 25 微型面包车 5 小货车 26 MPV 6 SUV 27 轿跑 7 中型客车 28 微卡 8 摩托车-非机动车 29 皮卡 9 行人 30 中卡 10 校车 31 轻卡 11 泥头车-渣土车 32 重卡 12 高危车 33 出租车 13 骑行人 34 油罐车 14 微型轿车 35 吊车 15 小型轿车 36 海外摩托车 16 紧凑型轿车 37 公交车 17 两厢轿车 38 自行车 18 三厢轿车 39 三轮车 19 轻客 40 电瓶车 20 小型SUV 512 全部 21 紧凑型SUV - - 表5 vehicle_color 车辆颜色 车辆颜色枚举值 释义 车辆颜色枚举值 释义 1 白色 8 棕色 2 灰色（银色） 9 黑色 3 黄色 10 紫色 4 粉色 11 桔色 5 红色 12 青色 6 绿色 13 金色 7 蓝色 14 银色 表6 car_pre_brand/car_pre_brand_index 车款类型 车款枚举值 释义 车款枚举值 释义 车款枚举值 释义 车款枚举值 释义 1 GMC 2 Jeep 3 MG 4 MINI 5 smart 6 一汽 7 三菱(东南) 8 三菱 9 上汽大通 10 东南 11 东风 12 东风小康 13 东风风度 14 东风风神 15 东风风神 16 中兴 17 中华 18 中顺 19 丰田 20 五十铃 21 五菱汽车 22 众泰 23 依维柯 24 保时捷 25 克莱斯勒 26 兰博基尼 27 凯迪拉克 28 别克 29 力帆 30 北京汽车 31 北汽制造 32 北汽威旺 33 华普 34 华泰 35 华泰（现代） 36 双环 37 双龙 38 吉利 39 启晨 40 哈飞 41 大众 42 大发 43 奇瑞 44 开瑞 45 奔驰 46 奥迪 47 威麟 48 宝马 49 宝骏 50 中通 51 北方 52 华西 53 友谊 54 四川现代 55 宇通 56 安凯 57 少林 58 扬子江 59 江淮 60 梅洛 61 福田 62 穗通 63 金旅 64 金龙 65 长安 66 青年 67 黄海 68 宾利 69 广汽传祺 70 广汽吉奥 71 悍马 72 捷豹 73 斯巴鲁 74 斯柯达 75 日产 76 昌河 77 本田 78 林肯 79 标志 80 欧宝 81 比亚迪 82 永源 83 汇众 84 江铃 85 沃尔沃 86 法拉利 87 海马 88 斯特拉 89 猎豹汽车 90 玛莎拉蒂 91 现代 92 现代或黄海 93 理念 94 瑞麒 95 福特 96 福迪 97 纳智捷 98 英菲尼迪 99 荣威 100 莲花 101 菲亚特 102 讴歌 103 三一重工 104 东风或者南郡或者大运 105 东风柳汽 106 中国重汽 107 五征或者飞碟 108 凯马 109 北京 110 北京威龙 111 北奔 112 北奔重卡 113 北汽 114 华棱 115 南郡或者东风 116 唐骏 117 大运 118 广汽田野 119 精工重卡 120 红岩 121 解放 122 跃进 123 金杯 124 陕汽 125 霸龙重卡 126 飞碟 127 起亚 128 路虎 129 道奇 130 铃木 131 长城 132 长安商用 133 陆风 134 雪佛兰 135 雪铁龙 136 雷克萨斯 137 雷诺 138 风驰 139 马自达 140 黄海（北京） 141 三轮车 142 五菱 143 华泰（现代） 144 吉利金球鹰 145 吉利帝豪 146 奔腾 147 广汽 148 猎豹 149 红旗 150 金杯或福田 151 重汽豪沃 152 北汽绅宝 153 广汽日野 154 黑豹 155 东风客车 156 哈弗 157 黄海客车 158 时代汽车 159 DS 160 欧曼 161 驭胜 162 成功汽车 163 北汽幻速 164 启辰 165 莲花汽车 166 东风风光 167 重汽王牌 168 联合卡车 169 衡山 170 福汽启腾 171 陕汽重卡 172 思铭 173 安源客车 174 申龙客车 175 中车时代 176 北汽新能源 177 齐鲁客车 178 南骏汽车 179 东风超车客车 180 奥驰汽车 181 庆铃 182 斯堪尼亚 183 重汽HOWO轻卡 184 九龙 185 搅拌车 186 厢式车 187 栏板车 188 其他 189 油罐车 190 大运重卡 191 上汽依维柯红岩 192 一汽通用 193 五洲龙客车 194 知豆 195 扬子江汽车 196 申沃客车 197 宝沃 198 汉腾汽车 199 潍柴英致 200 凯翼 201 SWM斯威汽车 202 野马汽车 203 华硕 204 观致 205 大运轻卡 206 一汽柳特 207 重汽豪瀚 208 重汽汕德卡 209 重汽斯太尔 210 WEY 211 腾势 212 比速汽车 213 阿斯顿马丁 214 萨博 215 陕汽通家 216 康迪全球鹰 217 长安跨越 218 卡威 219 南京金龙 220 广客 221 皮卡 222 迈凯伦 223 校车 224 领克 225 缔途 226 劳斯莱斯 227 公共巴士 228 未知 229 吊车 230 阿尔法罗密欧 231 GMC - - 表7 plate_type 车牌类型 告警类型枚举值 释义 告警类型枚举值 释义 告警类型枚举值 释义 告警类型枚举值 释义 0 未知类型 17 新能源牌 120 香港车牌 153 阿根廷车牌 1 单层蓝牌 18 其他类型 130 巴西私家车牌 160 南非私家车牌 2 单层黑牌 19 教练车牌 131 巴西商用车牌 161 南非官方车牌 3 单层黄牌 20 民航车牌 132 巴西官方车牌 162 南非外交车牌 4 双层黄牌 22 应急车牌 133 巴西外交车牌 163 南非警车牌 5 白色警牌 23 非机动车双层蓝牌 134 巴西摩托车牌 164 南非军车牌 6 白色武警 24 使馆车牌 135 巴西车牌 165 南非摩托车牌 7 双层白色武警 25 挂车车牌 140 墨西哥私家车牌 166 南非车牌 8 单层军牌 26 摩托车黄牌 141 墨西哥公交车牌 170 加纳私家车牌 9 双层军牌 27 摩托车蓝牌 142 墨西哥出租车牌 171 加纳官方车牌 10 领馆车牌 100 印尼私家车牌 143 墨西哥卡车牌 172 加纳外交车牌 12 港牌 101 印尼公共交通车牌 144 墨西哥摩托车牌 173 加纳商用车牌 13 澳门牌 102 印尼使馆车牌 145 墨西哥车牌 174 加纳摩托车牌 14 农用车牌 拖拉机 103 印尼车牌 150 阿根廷私家车牌 175 加纳车牌 15 厂内牌 110 沙特私家车牌 151 阿根廷官方车牌 180 台湾车牌 16 个性化车牌 111 沙特公共交通车牌 152 阿根廷摩托车牌 - - 父主题： 附录

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 devices 是 Array of strings 要移动设备ID集合：数组长度范围[1,100] 单个设备： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 failed_num Integer 删除设备失败的总数 devices Array of DeleteDeviceResult objects 删除设备详细结果信息 表5 DeleteDeviceResult 参数 参数类型 描述 device_id String 设备ID，设备唯一标识符 result ResultInfo object 结果信息 表6 ResultInfo 参数 参数类型 描述 code String 单个结果码 msg String 单个结果信息

响应示例 状态码： 200 OK { "device_id": "952352LWXT***", "device_name": "测试设备", "device_state": "ONLINE", "access_protocol": "HOLO", "device_type": "IPC", "device_system_state": "NORMAL", "description": "test", "model": "JVS-N71-HD", "manufacture": "JOVISION", "channel_total": 10, "stream_total": 2, "firmware": "V1.0", "device_ability" : "ptz,talk", "device_cloud_ability": { "alarm_voice": { "support": "true" }}, "create_time": "2020-06-26 20:42:16", "update_time": "2020-06-26 20:42:16", "protocol_version": "2.0.0", "mac": "xxx", "device_ip": "xxx.xxx.xxx.xxx", "device_port": "8090", "device_org_id": "1234567890***", "device_org_name": "测试组织***", "operator_total": "2", "sdk_ability": "***", "sn": "952352LWXT***" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 mac String 设备mac地址 device_id String 设备ID，设备唯一标识符，如：2102412969WLMB002258 device_name String 设备名称 device_state String 设备状态 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 access_protocol String 接入类型 枚举值： GB28181 国标 HOLO 好望 device_type String 设备类型 枚举值： IPC 通用相机 NVR NVR设备 MEdge IVS1800设备 IPC-BULLET 枪机 IPC-BOX 筒机 IPC-CONCH 半球/海螺 IPDOME 球机 device_system_state String 设备系统冻结 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 description String 设备描述 model String 设备型号，如：D2150 manufacture String 生产厂商，如：HUAWEI channel_total Integer 通道总数 stream_total Integer 每个通道码流数量 firmware String 摄像头固件版本号 device_ability String 设备能力集：枚举类型，参考附录设备能力集，多个能力集用逗号分隔 device_cloud_ability Object 云端能力集规格 create_time String 创建时间 update_time String 更新时间，在设备重新上线后或者移动设备分组后会修改时间 protocol_version String 设备与平台接入协议版本，如：2.0.0 device_ip String 设备IP device_port String 设备端口 device_org_id String 设备组织ID sn String SN号，等于device_id——设备ID，设备唯一标识符 device_org_name String 设备所处的设备组织名称 operator_total String 操作员总数 sdk_ability String sdk能力集