华为云用户手册

概述 行业视频管理服务是华为云围绕安全防范、生产管理、智慧运营等场景的机器视觉云服务统称，通过行业视频管理、好望开发平台、好望商城等智慧云服务，为企业用户提供智能原生的端云协同行业视频云服务解决方案，助力企业数字化转型，行业视频管理服务拥有以下优势： 视频体验： 全云加速，一点即播； 同等带宽下更清晰的体验； 网络抖动下更流畅的体验。 数据安全： 深入骨髓的数据安全理念； 华为 云安全 加持的行业视频管理服务数据“五不”原则； 满足华为云80+项安全合规标准。 智能原生： 围绕智能全生命周期管理的架构体系； 智能生产、交易、应用全闭环。 开放生态： 开放安全的接入生态，兼容多终端便捷接入； 智能算法生态持续繁荣； 场景化API使能丰富的应用生态。

调用说明 媒体处理 提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时媒体处理还提供了完备的SDK接口供您使用： SDK提供了直播能力和回放能力，直播功能包含直播预览，直播音频，直播抓图，直播录像，语音对讲；回放功能包括设备录像回放和云端录像回放，包含录像查询，录像日历，录像回放视频，录像回放音频，录像回放跳转，录像回放暂停/播放，录像回放倍速控制，回放抓图，回放录像。 SDK下载地址：https://console.huaweicloud.com/apiexplorer/#/sdkcenter/IVM SDK支持平台：安卓（HoloSens-Android-SDK）、IOS（HoloSens-IOS-SDK）、PC（HoloSens-PC-SDK）、WEB插件（HoloSens-Smart-WebPlugin）

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 ak 是 String 用户认证AK。 支持大小写字母，数字，特殊字符（-_），长度范围[1,64]，获取方式参考获取user ID与下载AK/SK章节。 sk 是 String 用户认证SK。 支持大小写字母，数字，特殊字符（-_），长度范围[1,64]，获取方式参考获取user ID与下载AK/SK章节。 force_update 否 boolean 强制更新标识符。 AK当前仅持有 一个AccessToken 且剩余有效期小于等于两天时，可通过此参数获取新的 AccessToken 使用；其他场景传此参数不解析。

URI POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求示例 添加摄像机巡航轨迹 POST /v1/2562572829***/devices/952352LWXT***/channels/1/cruise-track{ "cruise_type" : "CRUISE_TRACK", "cruise_name" : "巡航轨迹名称", "cruise_points" : [ { "preset_index" : 1, "dwell_time" : 30, "speed_level" : 2 } ]}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 cruise_type 是 String 巡航轨迹类型：枚举类型 枚举值： CRUISE_TRACK 巡航轨迹 MODEL_TRACK 模式轨迹 PAN_TRACK 水平轨迹 TILT_TRACK 垂直轨迹 说明： 目前设备只有CRUISE_TRACK模式——基于预置点的巡航，当选择其他模式时，设备还是按照CRUISE_TRACK模式在实现，因此为避免混淆，建议传参为CRUISE_TRACK。 cruise_name 是 String 巡航轨迹名称：数字、中文、英文、空格、-、_，.，长度范围[1,128] cruise_points 是 Array of CruisePoint objects 预置位列表，不允许为空，来源于查询摄像机预置位列表 表4 CruisePoint 参数 是否必选 参数类型 描述 preset_index 是 Integer 预置点位序号：取值范围[1,512] dwell_time 是 Integer 预置位停留时间：取值范围[30,3600] speed_level 是 Integer 移动速度：取值范围[0,10]，0最慢，10最快

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/security-key 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

URI DELETE /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

URI POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-detail 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_num 是 Integer 开启码流数 max_frame_rate 是 Integer 全帧率，最大帧率，取值为设备码流能力列表包含的全帧率 stream_info 是 Array of SetStreamDetailInfo objects 各码流信息 corridor_mode_open 否 Boolean 走廊模式是否开启：枚举类型 枚举值： false 关闭 true 开启 mirror_mode 否 Integer 镜像模式：枚举类型 枚举值： 0 不开启镜像 1 水平镜像 2 垂直镜像 3 水平垂直镜像 variable_bit_rate_open 否 Boolean 动态码率是否开启：枚举类型 枚举值： false 关闭 true 开启 variable_bit_rate 否 Integer 动态码率值正整数 variable_frame_rate_open 否 Boolean 动态帧率是否开启：枚举类型 枚举值： false 关闭 true 开启 variable_frame_rate 否 Integer 动态帧率值正整数 表4 SetStreamDetailInfo 参数 是否必选 参数类型 描述 stream_type 是 Integer 码流类型：枚举类型 枚举值： 0 主码流， 1 子码流1 2 子码流2 encode_type 是 Integer 编码类型：枚举类型 枚举值： H.264 H.265 resolution 否 String 分辨率 frame_rate 否 Integer 帧率 bit_rate_type 否 Integer 码率类型(H264/H265生效)：枚举类型 枚举值： 0 定码率 1 变码率 bit_rate 否 Integer (定码率)码率值/(变码率)：取值范围[512, 16384]* intelligence_encoding_open 否 Boolean 智能编码是否开启(H264/H265生效)：枚举类型 枚举值： false 关闭 true 开启 intelligence_encoding_level 否 Integer 智能编码级别(H264/H265生效)：取值范围[1, 5] slice_encoding_open 否 Boolean 多Slice编码是否开启(H264/H265生效)：枚举类型 枚举值： false 关闭 true 开启 layered_encoding_open 否 Boolean 分层编码是否开启(H264/H265生效)：枚举类型 枚举值： false 关闭 true 开启 profile 否 Integer 编码质量(H264/H265生效)：枚举类型 H264枚举值： 2 Base profile, 1 Main profile 0 High profile; H265枚举值： 0 Main profile i_frame_interval 否 Integer I帧间隔(H264/H265生效)：取值范围[1, 500] jpeg_quality 否 Integer Jpeg图像质量(MJPEG生效)：取值范围[1, 99] bit_rate_mode 否 Integer 定码率类型：枚举类型 枚举值： 1 帧率优先 2 图像质量优先 pic_quality 否 Integer 变码率图像质量：枚举类型 枚举值： 1 最好 2 次好 3 较好 4 一般 5 较差 6 差

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track/list 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 device_id String 设备ID channel_id String 通道ID cruises_ids Array of GetCruiseTracksItem objects 巡航轨迹ID列表 表4 GetCruiseTracksItem 参数 参数类型 描述 cruises_id Integer 巡航轨迹ID cruises_name String 巡航轨迹名称 enable_cruise String 启停状态，枚举值： OPEN：开启 CLOSE：关闭

调用准备 NVR在线并且有足够的硬盘空间（空间不足会导致无法获取名单库分组），硬盘空间可在NVR设备界面的“存储管理”中确认。 NVR下至少要有一个支持目标识别功能的SDC在线。 导入的目标base64图片数据不要超过40KB，以免图片过大导致导入失败。 接口调用前需确认好环境地址端口、URL、请求方式、请求参数字段与类型等信息。 NVR从8.1.RC1.B015版本开始就支持名单导入，SDC需要包含或能安装目标识别算法包的型号，如C2150、C2120等。

状态码 返回的状态码参考如下表所示： 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout 网关超时。 父主题： 附录

URI POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position/move 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 control_token 是 String 用户设备控制token（从获取云台控制权接口获取） preset_index 是 String 预置位序号：取值范围[1,512]

URI PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 preset_index 是 Integer 预置位序号：取值范围[1,512] preset_name 是 String 预置点位名称：支持数字、中文、英文、空格、-、_，.，长度范围[1,128]

URI GET /v1/{user_id}/targets/count 表1 路径参数 参数 是否必选 参数类型 描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK 表2 Query参数 参数 是否必选 参数类型 描述 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 group_id 是 Integer 目标库分组ID，非负值，从获取目标库分组接口获取

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 abilities Array of StreamAbilityItem objects 码流能力列表 channel_no Integer 视频通道ID is_support_corridor_mode Boolean 是否支持走廊模式 is_support_water_mark Boolean 是否支持水印，取值范围：true – 支持；false – 不支持 mirror_mode MirrorMode object 镜像模式 variable_bit_rate VariableBitRate object 动态码率 variable_frame VariableFrame object 动态帧率 h264_info EncodeInfo object H264编码信息 h265_info EncodeInfo object H265编码信息 mjpeg_info EncodeInfo object MJPEG编码信息 digital_zoom_info DigitalZoomInfo object 数字变倍信息 roi_info ROIInfo object ROI（感兴趣区域）信息 vo_info VOInfo object VO模拟输出能力 osd_info OSDInfo object OSD信息 is_hide_sub_stream_for_main_mjpeg Boolean 主码流MJPEG开启时是否隐藏子码流 表4 StreamAbilityItem 参数 参数类型 描述 stream_count Integer 码流数量 max_frame_rate Integer 最大帧率 stream_info Array of StreamInfo objects 码流信息 表5 StreamInfo 参数 参数类型 描述 stream_type Integer 码流类型：枚举类型 枚举值： 0 主码流， 1 子码流1 2 子码流2 encode_mode Array of EncodeMode objects 编码信息列表 support_crop Boolean 是否支持裁剪：枚举类型 枚举值： false 不支持 true 支持 support_eptz Boolean 是否支持电子云台：枚举类型 枚举值： false 不支持 true 支持 表6 EncodeMode 参数 参数类型 描述 type String 编码类型：枚举类型 枚举值： H.264 H.265 MJPEG resolution Array of Resolution objects 分辨率列表 表7 Resolution 参数 参数类型 描述 type String 分辨率长和宽为数字，通过*分隔 frame_rate Array of integers 帧率列表 bit_rate BitRate object 该分辨率对应的码率信息 表8 BitRate 参数 参数类型 描述 support Boolean 该分辨率对应的是否支持码率配置* begin Integer 该分辨率对应的码率最小值* end Integer 该分辨率对应的码率最大值* default Integer 该分辨率对应的码率默认值* 表9 MirrorMode 参数 参数类型 描述 support Boolean 是否支持镜像模式：枚举类型 枚举值： false 关闭 true 开启 type Array of integers 镜像类型：枚举类型 枚举值： 0 不开启镜像 1 水平镜像 2 垂直镜像 3 水平垂直镜像 表10 VariableBitRate 参数 参数类型 描述 support Boolean 是否支持动态码率：枚举类型 枚举值： false 关闭 true 开启 表11 VariableFrame 参数 参数类型 描述 support Boolean 是否支持动态帧率：枚举类型 枚举值： false 关闭 true 开启 表12 EncodeInfo 参数 参数类型 描述 intelligence Intelligence object 智能编码信息 is_support_slice Boolean 是否支持多Slice编码 is_support_layered_encoding Boolean 是否支持分层编码 profile_list ProfileList object 编码复杂度类型 i_frame_interval IFrameInterval object I帧间隔 bit_rate_info BitRateInfo object 码率信息 jpeg_quality JpegQuality object jpeg质量 表13 Intelligence 参数 参数类型 描述 support Boolean 是否支持智能编：枚举类型 枚举值： false 关闭 true 开启 type Array of integers 支持智能编码类型 表14 ProfileList 参数 参数类型 描述 support Boolean 是否支持编码复杂度类型：枚举类型 枚举值： false 关闭 true 开启 type Array of integers 枚举类型 H264编码枚举值： 0 High profile， 1 Main profile 2 Base profile H264编码枚举值： 0 Main profile 表15 IFrameInterval 参数 参数类型 描述 support Boolean 是否支持I帧间隔：枚举类型 枚举值： false 关闭 true 开启 begin Integer I帧间隔最小值 end Integer I帧间隔最大值 表16 BitRateInfo 参数 参数类型 描述 support Boolean 是否支持：枚举类型 枚举值： false 关闭 true 开启 bit_rate_type Array of BitRateType objects 码率类型：枚举类型 枚举值： 0 定码率 1 变码率 表17 JpegQuality 参数 参数类型 描述 begin Integer jpeg质量最小值：1 end Integer jpeg质量最大值：99 表18 BitRateType 参数 参数类型 描述 type Integer 码率类型 bit_rate_mode Array of integers 定码率类型：枚举类型 枚举值： 1 帧率优先 2 图像质量优先 pic_quality Array of integers 变码率图像质量：枚举类型 枚举值： 1 最好 2 次好 3 较好 4 一般 5 较差 6 差 表19 DigitalZoomInfo 参数 参数类型 描述 max_zoom Integer 数字变倍支持的最大倍率 support Boolean 是否支持数字变倍 表20 ROIInfo 参数 参数类型 描述 support Boolean 是否支持感兴趣区域编码：枚举类型 枚举值： false 关闭 true 开启 roi_quality ROIQuality object 感兴趣区域编码质量能力对象 表21 ROIQuality 参数 参数类型 描述 begin Integer 最小值 end Integer 最大值 表22 VOInfo 参数 参数类型 描述 param VOInfoParam object 参数 support Boolean 是否支持模拟输出能力：枚举类型 枚举值： false 关闭 true 开启 表23 VOInfoParam 参数 参数类型 描述 channel_no String 通道号 表24 OSDInfo 参数 参数类型 描述 support Boolean 是否支持OSD：枚举类型 枚举值： false 关闭 true 开启

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-ability 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

设备能力集 设备能力集 释义 ptz 云台控制能力 talk 对讲能力 localstorage 本地存储能力 flowstatis 客流统计能力 intelligent 智能分析能力 cloudstorage 云端录像能力 alarmvoice 报警声音能力 brotate 画面旋转能力 mediaencryptgcm 媒体加密算法能力 soundlightalarm 声光告警能力 algorithm 算法能力 reportupgrade 升级状态上报能力 logcollect 日志采集能力 audiovideoswitch 音视频切换能力 sdcardformat SD卡格式化能力 lightcontrol 指示灯开关能力 wifiinfo 网络配置信息能力 supplement 补光灯能力 certdelive 证书下发能力 batch_upgrade 批量更新能力 ptzspin 云台转动能力 zoom 缩放能力 autofocus 自动聚焦能力 volumnset 音量调节能力 reset 远程重置能力 maskmode 隐私遮蔽能力 motionflow 移动追踪能力 iris 云台-光圈能力 preset 云台-预置位能力 cruise 云台-巡航 securitykey SDC密码设置能力 tlvframe tlv显示框能力 alarmsound 声音警戒能力-有声光警戒能力此能力不显示 alarmlight 灯光警戒能力-有声光警戒能力此能力不显示 microphone 拾音器能力 devnormalrecord 设备前端录像支持连续录像能力 abilityauth 支持目标识别和特征协同功能 ptz_3d_locate 3d云台控制能力 父主题： 附录

响应示例 状态码： 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 } } } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 versions 是 Array of versions objects 设备版本 need_specification 否 Boolean 是否需要返回具体规格，不传默认false ability 否 Array of strings 查询的云上能力集列表，不传默认查询所有能力集 表4 versions 参数 是否必选 参数类型 描述 device_type 是 String 设备类型，必填，可以通过用户根据设备ID查询设备信息详情获取 firmware 是 String 设备软件版本，必填，可以通过用户根据设备ID查询设备信息详情获取 model 是 String 设备固件类型（设备款型），必填，可以通过用户根据设备ID查询设备信息详情获取

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 abilities Array of DeviceVersionAndAbilities objects 设备版本对应能力集返回体 表6 DeviceVersionAndAbilities 参数 参数类型 描述 device_type String 设备类型 model String 设备款型 firmware String 设备软件版本 abilities Object 设备能力集规格

请求示例 通过版本查询设备能力集 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" ] }

URI PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/security-key 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID校验：目前只支持好望设备，取值范围[-1,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/targets/authorization 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 目前只支持好望设备，取值范围[-1,999]。通道id传-1时代表只查询设备本身，传通道id时查设备及通道。 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 current_security_key 是 String 设备当前密码：初始化设置密码时可不填 new_security_key 是 String 设备新密码：字符组成（大写字母、小写字母、数字、特殊字符至少两项，且不能与用户名或用户名的倒序相同），长度范围[8,20]

响应示例 状态码： 200 OK { "device_id" : "952352LWXT***", "targets" : [ { "name" : "mark", "gender" : "male", "age" : 24, "country" : "中国", "nation" : "汉", "native" : "杭州", "occupation" : "工人", "work_no" : "124****77", "phone" : "15********61", "email" : "1*********@qq.com", "domicile" : "杭州", "remark" : "无", "jpegBase64" : "/9j/4AAQSkZJRgABAQAAAQABAAD...", "target_id" : "2", "external_target_id" : "1234567890123***" } ]}