海康威视接口调用报错处理

1.批量添加人员

处理方法：

注：身份证有些服务器配置的时候可能会必填，且不能重复

 2.人脸添加接口问题

图片压缩为base64后需要在10KB-200KB之间，上传的base64需要丢掉头，从/9开始，不然不显示

1)原因1：base64头不要放在base64编码中使用，即：

2)原因2：base64编码是非常长的，复制的时候，没有复制全；

3)原因3：图片太大了，要保持图片在10K-200K ；

注意压缩为base64时，压缩格式为：jpeg格式，不然不是从/9开始，图片上传上去会失真

3.平台上传图片不显示

安装一下证书，不然上传的正常图片都会显示不正常

 4.批量开卡服务器返回错误

【错误码】0x04a12601

【错误码释义】系统内部错误；
【错误建议】1.检查tomcat服务是否正运行2.请登录到运管中心查看人员发卡服务是否正常运行3.请将日志导出后发给研发人员分析处理，日志位置：hikvisionwebcomponents omcat85win64.2logscis。

 处理方法:

这个问题有点坑，我的问题仅仅就只是因为人员Id不存在导致的

5.权限接口配置问题

一、json解析错误

处理方法：

最新版本的接口版本里面的head是为null的，往head塞一个tagId就能够解析成功 

 

二、tagId报错

处理方法：

A解决. 跟批量添加人员一样处理

B解决.JSON解析失败添加了请求头，并添加了tagId，tagid用成frs 固定

6.平台缺少对应组件

当请求接口返回如下报错：

{

"code": "0x0240103a",

"msg": "No available service.The component maybe not installed.",

"data": {

"componentId": " nms ",

"serviceId": "nmsweb"

}

}

这种报错是由于平台缺少对应组件，需要进运管中心进行安装；

* 如何确定缺少哪个组件？ 需要关注报错信息中 componentId 后跟的组件标识，这个就是平

台缺少的对应组件；例如上述示例中"componentId": " nms ",就表示平台缺少 nms 这个组件

* 如何安装对应组件？ 进入运管中心-系统维护-安装部署-软件包管理页面，在搜索框内填入

对应的组件标识，然后选择对应的组件点击安装即可（如果无法登录运管中心或者安装过程

出现问题可以联系负责项目的海康技术协助）

* 安装后必须要的操作？ 安装后需要重启 artemis，否则接口调用仍会报错；进入运管中心-

状态监控-搜索 artemis 找到 api 网关-重启 artemis

7.门禁人员权限配置问题

1. 接口添加的权限配置在平台上看不到，在平台上添加的权限接口里查不到

这个是因为接口中调用的是 acps 组件，平台上用的是 acs 组件，截止 1.3.0 版本， acps

和 acs 还没有做通，所以，两者之间相互查不到对应的权限配置及下载记录等。

2. 通过接口下发人脸，返回下载数量为 0

常见原因包括以下几种：

a) 对应的人员没有下发卡权限，目前设备上还是以卡为中心的默认，下发人脸需要先下发

卡权限 (taskType=1) ，通常 taskType 传 5 就是卡权限和人脸一起下发；

b) 接口在往非人脸设备上下发，人脸只支持下发到人脸设备，经常会有第三方不对设备类

型进行区分，把人脸往门禁控制器上下发。

3. 人脸下发失败

常见原因包括以下几种： a) 平台上录入的人脸照片质量不符合要求，这种情况接口中返回人脸下发失败的原因；

b) Ehome 协议接入的门禁人脸设备，下发人脸的时候， dac 是把人脸照片的图片 url 下发

给设备，由设备主动从 asw 下载图片，如果门禁设备在外网， asw 的多线路没有配置，

或者端口没有映射，会导致门禁设备下载人脸失败；

c) Ehome 协议接入的门禁人脸设备，下发人脸还需要在 pstor 中配置 kms 资源池和 pss 资

源池。

4. 添加权限配置接口返回的 taskId 查询进度无数据返回

添加权限配置接口是异步接口，也就是调用接口后，接口直接返回一个 taskId ，平台内

部在异步增加权限配置，接口返回的 taskId 是用来查询权限配置进度，查询权限配置进度的

接口基线还没有对外开放，需要安装资源包。

遇到问题可以直接官网询问官方技术人员，他们给的答案更全面一些，错误码直接复制到窗口，智能机器人会告诉您关于此个错误码的原因，记得登录注册哟

客服中心：海康开放平台