目录前言：.......................................................................................................................................................2一、对接前文档准备...................................................................................................................3对接常用的各类插件、开发包：海康盘地址打包下载......................................................4基础术语普及：................................................................................................................................4必备条件：.........................................................................................................................................8二、常见对接工作：.................................................................................................................101、开发对接前准备工作：.........................................................................................................102、在线调试.....................................................................................................................................103、必须知道的几个问题：.........................................................................................................11三、常见问题解答......................................................................................................................133.1平台接口调不通，返回报错。..........................................................................................133.2视频常见问题..........................................................................................................................153.2实时获取平台人员刷卡刷脸事情、车辆出入，单兵GPS位置事件等................223.3门禁对接常见问题与功能...................................................................................................323.4人员、组织、区域相关........................................................................................................343.5人脸评分接口常见问题........................................................................................................393.6获取4G移动设备GPS信息...............................................................................................413.7停车场常见问题......................................................................................................................423.8合作方无法发送https请求或需重写认证.....................................................................423.9其它问题...................................................................................................................................43四、修订记录...............................................................................................................................45前言：目前我们对接的平台主要为综合安防、智能应用平台，统称为新体系，通过平台自身的
研报：中国央行即将发行的央行数字货币和Libra存在本质差别:零壹智库发布研报《人民币3.0——中国央行数字货币：运行框架与技术解析》，其中提到，中国央行即将发行的央行数字货币和Libra存在本质差别。中国央行数字货币是由中国央行发行的法定货币，是中央银行的负债，由中央银行进行信用担保，具有无限法偿性（即不能拒绝接受央行数字货币）。而Libra是一种尚未得到监管许可的数字货币。虽然Libra的价值与一篮子货币挂钩，但它仍在很大程度上会对现有货币体系造成冲击，挤占现有各国法定货币的使用空间。[2020/3/2]
密级级别：外部公开海康威视版权所有3开放能力进行对接，为第三方通过我方平台获取相关数据，并非我方进行开发，这点请明确，平台接口修改会产生定制工作，如有接口定制需求，请走定制评估流程。API网关组件对外提供各种完善的数据接口，数据接口返回格式统一为JSON数据格式，对接统一为RESTFUL接口，通过http/https协议对接。我方提供调用权限、服务地址、插件、对接技术支持，对接前，关于以下内容请各位悉知，如有文档中暂无解决办法的，请按照SDK支持流程中联系对应的人，感谢支持。以下是对接中的专业词汇解释，如有需要可点击查看了解：JSON格式：点此查看详细信息与示例RESTFUL接口：点此查看详细信息与示例HTTP与HTTPS协议：点此查看详细信息与示例注：本文档会随着各个地区对接问题的解决进行常见问题的汇总并保持更新对接须知：请第一时间将平台版本截图发到群里，群名可以加上平台版本。平台版本确认见基础术语普及->平台版本的确认章节。一、对接前文档准备ISC：OpenApi对接在线文档IoT：OpenApi对接在线文档
密级级别：外部公开海康威视版权所有4对接常用的各类插件、开发包：海康盘地址打包下载基础术语普及：1、平台首页地址：平台首页地址是指输入IP地址跳转出来的页面，如下图：输入用户名和密码之后的界面：2、运管地址：平台地址加上8001端口/center的页面，如下图：
密级级别：外部公开海康威视版权所有5输入用户名和密码之后的界面：3、平台版本的确认API对接群必须先了解对应的平台版本，最好对接群名加上平台版本。如XXXX项目对接群_ISC1.3.0登陆平台首页，点击关于即可，如下图：
密级级别：外部公开海康威视版权所有64、接口查询ISC最新版本接口地址：https://open.hikvision.com/docs/6f388b5f96924abfb503768a61aa0dd4
密级级别：外部公开海康威视版权所有7ISC历史接口地址：https://open.hikvision.com/docs/37e38899e583cfe4f9879a07a5294bf45、平台重启如下图再运管中点击一键重启即可，点击之后，一般需要等待20分钟左右，20分钟之内不要对平台做任何操作。
密级级别：外部公开海康威视版权所有8必备条件：1、平台部署安装完成，api组件安装完成，平台已授权2、登录运管中心http://ip:8001/center，获取appkey与secrect，如下图：
密级级别：外部公开海康威视版权所有9
密级级别：外部公开海康威视版权所有10二、常见对接工作：1、开发对接前准备工作：开发资源包与文档下载：如下链接：https://open.hikvision.com/download/5c67f1e2f05948198c909700?type=10需先注册账号，对外开放的，正常注册就行。2、在线调试请参照上面几张图，进入api管理，使用在线调试工具进行各个接口的调试与查询，如需要对接视频取流预览回放，就搜预览/回放，会查出对应的在线接口文档，可以直接进行在线调试获取取流地址或者回放地址，其中模拟数据仅用来参考数据格式，并未产生实际的调用请求。如下图，参数说明可以点击接口名称查看：
密级级别：外部公开海康威视版权所有113、必须知道的几个问题：各个对接经常或需要获取必须的几个数据，如设备数据、监控点数据、门禁数据等，以下是几个常用数据接口：1、获取平台设备信息：a)编码设备与监控点设备信息查询，如下接口文档：https://open.hikvision.com/docs/741bcdc108014f6980
密级级别：外部公开海康威视版权所有12b0b49ab4c86e41Billions项目组e8b45b71
声音 | 报告：2018年加密基金占对冲基金发行的20%:一项新的研究发现，尽管市场看跌，但加密货币对冲基金的发行数量在2018年大幅增加。根据Crypto基金研究公司(Crypto Fund Research)的数据，Crypto基金目前占2018年对冲基金发行总额的20%。截至今年第三季度末，该行业已推出90只加密货币基金，到第四季度末，这个数字可能高达120只。这比2017年高出1.69%，比2016年高出471%。总体而言，预计今年将有600家对冲基金上线。[2018/10/15]
密级级别：外部公开海康威视版权所有135.对接调用demo三、常见问题解答3.1平台接口调不通，返回报错。排查步骤：1、使用平台在线调试功能，调试是否能够调通接口。调试方法参见本文档中：二、常见对接工作->2、在线调试如果在线调试能够调通，那么证明平台接口没有问题，需要检查一下对接的代码。1)Host地址配置正确，appkey和secret生效并且有权限。2)是否存在内外网问题？如果是，请将技术同事检查一下集群代理配置是否正确，在外网是否能够访问到平台。如果还是有问题：请参照以下demo进行调用GetCameraRes.java
密级级别：外部公开海康威视版权所有14地址和端口为平台首页的地址和端口，如下图中ArtemisConfig.host应该为47.96.145.218:446协议为https
密级级别：外部公开海康威视版权所有153.2视频常见问题1、预览接口获取到的取流地址播放不了请先用vlc播放器尝试是否可以正常播放，且如果vlc的版本是否3.5.9的版本。请换一个版本。1)请检查该监控点在平台上是否可以取流回放(不是双击播放，是右键点击监控点，选择非直连预览)。如果平台无法播放视频，让技术同事帮忙排除设备是否有问题，是否在线。2）确认平台是否有内外网，如果有内外网，则让技术同事确认一下平台的端口映射有问题。如无问题，检查新增的外网appkey和Secret是否配置正确。正确的配置如下图(domainId必须选择外网的网域ID)：3)前二步确认没有问题，检查一下取流协议参数：协议是RTSP：是否传了以下字段"expand":"streamform=rtp"
密级级别：外部公开海康威视版权所有16完成的入参示例：{"cameraIndexCode":"748d84750e3a4a5bbad3cd4af9ed5101","streamType":0,"protocol":"rtsp","transmode":1,"expand":"streamform=rtp"}小提示：流传输格式如果不用rtp，需要使用PS格式，则按照以下截图进行配置转码：
密级级别：外部公开海康威视版权所有17协议是RTMP、HLS：前端相机的流格式必须是H264以及音频格式是AAC。HLS取流传参：{"cameraIndexCode":"311b1237d72843a68dabf4a61c62a662","streamType":0,"protocol":"hls","transmode":1}RTMP取流传参：{
密级级别：外部公开海康威视版权所有18"cameraIndexCode":"311b1237d72843a68dabf4a61c62a662","streamType":0,"protocol":"rtmp","transmode":1}4)rtsp协议可以预览，rtmp协议无法预览ISC1.2.0版本需要打mgc的补丁包，《mgc_hf_20191018_PN302944_V5.7.0_十月份问题缺陷补丁合集.zip》另：为保证数据的安全性，取流URL设有有效时间，有效时间为5分钟。其它问题导致无法播放，请先认真看下取流接口说明，看是否存在取流接口说明描述的问题。5)rtsp协议可以预览，hls协议无法预览首先前端相机的视频格式要求为H264，音频格式是AAC。VLC3.0.10版本的无法播放，用VLC2.2.4版本的可以正常预览。2、回放接口取的流url无法播放1)先按上述预览接口无法播放，排查相关问题。2)协议是HLS的无法播放。则请确认以下前提。HLS取流回放需要云存储支持：HLS协议3)rtmp协议无法回放ISC1.2.0版本除了需要mgc的补丁包之外，还需要打vnsc的补丁包，《vnsc_hf_20190225_171443_V1.8.0_修复回放url中时间格式缺少毫秒问题.zip》
R3创始人：2020年将出现央行发行的加密货币:今日在第三次DTCC金融科技讨论会（DTCC Fintech Symposium 2018）上，R3创始人Todd McDonald表示，到2020年时，将会出现央行发行的加密货币。区块链联盟R3是全球知名的区块链行业组织，旗下拥有100多家金融机构成员。[2018/3/23]
密级级别：外部公开海康威视版权所有19不打补丁的话，第三方获取到url后，按照这种格式把时间段拼接在后边播放。如下示例：rtmp://10.19.132.75:1935/vod/openUrl/ER9woMg?beginTime=20191213T100000&endTime=20191213T100500&playBackMode=1&fileSize=1024000原因：用短url直接取流的话，vnsc会把时间段解析成非国际化时间，mgc取流的时候会有问题。rtmp协议只支持H.264AAC编码格式，支持用VLC预览回放，不支持用hpsclient预览回放。4）rtsp协议无法回放请检查以下回放流格式回放流格式如下：rtsp://10.194.98.217:554/openUrl/jum5GDK?beginTime=20170615T000000&endTime=20200618T000000&playBackMode=1&streamform=rtprtmp回放取流入场示例：{"cameraIndexCode":"1e97a3604f6e4128b3022e033571fbe0","recordLocation":"1","protocol":"rtmp","transmode":1,"beginTime":"2020-01-08T00:00:00.000+08:00","endTime":"2020-01-09T00:00:00.000+08:00"}3、小结ISC平台提供都是标准的RTSP、RTMP、HLS取流协议，只需要先获取平台的监控点编号，在调用预览、回放取流接口即可。获取监控点视频，包括取流预览、取流回放。取流预览目前没有什么限制，需要注意的是前端相机的视频格式需要为H264格式，音频为ACC。取流协议简介：
密级级别：外部公开海康威视版权所有20HLS流：HLS协议的流也可能在客户那边的要求视频编码为m3u8，最大的特点是HLS的流很方便的在浏览器端直接播放，客户也可能需要将其应用到手机端的播放，因此，一般涉及到网页播放、手机播放、微信公众号播放的需求，基本都是需要HLS协议支持，但是ＨＬＳ协议流有一定限制。取流协议RTSP流：RTSP常用与客户端或者播放器插件，播放器插件可以从以下地址查找：播放器插件下载：包括WEB端插件、CBillions项目组/serviceSupport/patch/component/detail/PN302944ISC1.3.0平台，按时间顺序安装mgc补丁。然后运管中找到mgc的服务参数，打开即可。ISC1.4.100平台，再运管中找到mgc服务参数打开即可。如下图：
密级级别：外部公开海康威视版权所有22问题：调用获取监控点在线状态，online返回值为null解决方法:平台的巡检计划没有开启,把平台的视频巡检计划打开即可。问题：获取录像报"code":"0x0d200b26"错误解决方法：因为平台没有配置没配录像计划，或者平台就查不了录像。配置一下录像计划即可。3.2实时获取平台人员刷卡刷脸事情、车辆出入，单兵GPS位置事件等1、如何进行事件订阅，获取人员刷卡刷脸比对等数据按事件类型订阅事件:事件订阅参考地址：https://open.hikvision.com/docs/28e10567a3ec4b7aa107c79cbb1f9ae9
密级级别：外部公开海康威视版权所有23订阅原理：第三方与海康平台对接，根据事件类型订阅事件，传入事件类型码，事件级别，事件类型、回调函数地址，当该事件发生时，平台会向第三方的回调地址发送该事件的数据，具体数据内容请参照接口文档：事件列表：https://open.hikvision.com/docs/2c6c0ced640f403faa3a108cc9eb020c该接口用于满足应用方按事件类型码订阅事件，同一个用户重复订阅相同的事件，接口内部逻辑自动去重，确保不重复投递事件。事件订阅接口，支持订阅平台的所有业务的各种事件类型，具体参考附录D本接口要求，三方订阅的时候，要求三方指定的http/https接收事件的服务地址。后续平台产生对应的事件，会推送到此http/https服务地址。接口地址只支持IP，不支持域名。且订阅收到消息之后，要返回200OK,否则或造成消息堵塞，后续无法在继续接收到消息。事件订阅参数参照：{"eventTypes":,"eventDest":"https://ip:port/eventRcv",
Trust Machines聘请前Coinbase和纽约梅隆银行高管:金色财经报道，区块链初创公司Trust Machines聘请了Coinbase前高管Asiff Hirji和纽约梅隆银行前副总法律顾问Manas Mohapatra。
Hirji曾于2017年至2019年担任Coinbase总裁兼首席运营官，并以顾问的身份加入公司。他曾在多个行业担任多个董事职位，曾短暂担任风险投资公司a16z的顾问职位，目前在沃伦·巴菲特支持的Nubank担任类似职位。
Mohapatra加入信托机器公司担任法律总顾问。除此之外，他还曾担任Twitter的助理总法律顾问超过4年，并担任美国联邦贸易委员会的高级律师。另一位新增员工是Igor Sylvester，他将加入公司的工程团队。在此之前，他曾在Reddit担任软件工程师，并在Facebook领导了一个机器学习团队。（blockworks）[2022/6/29 1:39:47]
密级级别：外部公开海康威视版权所有24"subType":2,"eventLvl":}回调函数写法参照：/***事件回调*@paramjsonObject回调参数*/@RequestMapping("/test")@ResponseBodypublicStringeventDest(HttpServletRequestrequest){JSONObjectjsonObject=null;StringsTest="";InputStreamis=null;try{is=request.getInputStream();StringBuildersb=newStringBuilder();byteb=newbyte;for(intn;(n=is.read(b))!=-1;){sb.append(newString(b,0,n));}sTest=sb.toString();}catch(IOExceptione){e.printStackTrace();}jsonObject=JSONObject.parseObject(sTest);try{logger.info("收到回调信息"+jsonObject.toJSONString());
密级级别：外部公开海康威视版权所有25}catch(Exceptione){logger.error("回调出错！",e);return"";}2、订阅事件之后，接收不到消息。1)确认以下订阅的传的回调的地址，在平台的服务器上是否能够访问。排查方法：先确认回调函数的地址是否可以直接被访问，要求可以在浏览器中直接输入地址可以访问接口。再确认服务器到回调地址的网络是否畅通。排查日志：
密级级别：外部公开海康威视版权所有26设置日志级别，然后再频繁触发相关事件，稍等约5分钟再去这个路径下去查看日志文件。搜事件码或者回调函数地址。如果失败会有失败日志。2)修改els、esc事件级别为trace及以上，修改服务器设置，如下图：
密级级别：外部公开海康威视版权所有27触发事件后再去服务器上查询日志记录：3)检查订阅的参数传的是否有问题。正确示例如下：{"eventTypes":,"eventDest":"https://ip:port/eventRcv","subType":2,"eventLvl":}4）用api对接小工具测试是否能够收到消息，如果能收到，则合作方检测一下网络、入参。
密级级别：外部公开海康威视版权所有283、收到订阅返回的消息中没有图片信息下列以门禁事件举例排查相关问题。1)排查平台上的门禁事件是否有图片，如果没有，让技术同事确认设备上是否有图片。如2)果设备上也有，让技术同事确认平台的图片存储服务(ASW)是否配置正确。3)再esc配置一下联动事件。进入运管中心->状态监控，搜索事件服务，展示如下图点击服务参数配置，修改事件状态为"0,1,2,4"和事件等级为"0,1,2,3"，如下图
密级级别：外部公开海康威视版权所有29说明：具体事件状态和事件等级说明参考附录。点击保存并下发按钮，弹出确认下发界面，如下图，点击下发按钮。配置生效后，能订阅到联动事件。4)如果要获取停车场的带图片事件。需要再将事件状态改成0，1，2，3，4，5同时配置完之后要取消订阅，再重新订阅。4、小结1、平台的实时数据，如门禁、访客(门禁的人证认证比对事件)、报警、人脸抓拍、停车场出入、移动设备GPS数据都可以通过事件订阅接口获取。2、事件订阅接口支持多个事件一次订阅，但事件必须要是同一种事件类型。如既要门禁事件，也要访客事件，则需要分二次调用事件订阅接口。但如果是要门禁事件中人脸比对事件、人证比对事件，则只需要订阅一次eventTypes传
BitGo将面向机构投资者提供数字货币托管服务:区块链安全公司BitGo近期发布了新的托管服务，其将面向机构投资者提供数字货币托管。其产品部门负责人Tracy Olson强调，尽管目前公司的钱包产品涉及15%的比特币交易，但绝不会泄露经托管的比特币总资产数。[2018/5/14]
密级级别：外部公开海康威视版权所有303、如果不需要再接收事件，或者需要重新订阅事件，务必先取消之前的订阅。4、为了保证事件的实时性，事件的图片上传是异步，如停车场入场事件，产生了一次事件会收到二个消息，一个是不带图片的事件，一个是带图片的事件。5、合作方收到订阅的消息之后，一定要返回200OK。因为：1）平台推送事件，等待回复的周期约为30秒2）第三方不回复，平台日志会记录发送失败，此时第三方是否实际收到报文，要看第三方自己的接收逻辑。3）所以一般建议第三方接收事件，及时回复平台，避免此类事件推送失败的情况。6、推送的门禁事件没有人员身份证，工号即对接方需要确认这个人的唯一字段。综合安防平台因为是面向各个行业的统一平台，如果人员全部是由平台手动添加的(有的地方是用身份证做人员唯一标识，有的地方用工号做唯一标识，有些政府人名加组织是唯一标识，学校是学号做唯一标
密级级别：外部公开海康威视版权所有31识，所以平台统一自动生成一个personId做唯一标识)，那么人的唯一标识就是personId，门禁事件上传的人员唯一标识就是personId。解决方案：1、如果ISC1.4.100平台建议合作方自己通过接口添加人员、组织(方法详见3.4人员、组织、区域同步相关)，将合作方自己的唯一标识传入到personId字段中。这样后续门禁上传的事件中的ExtEventPersonNo就是自定义的人员唯一标识。2、如果是其它版本平台或者只能通过平台去添加人员，那么只能先获取平台所有人员信息，然后将人员ID和合作方的唯一标识做个缓存。后续收到门禁事件之后再通过personId反查人员信息。或者用personId再调用一次接口获取人员数据
密级级别：外部公开海康威视版权所有32如果对接方无法对接事件，或必须采用数据库方式同步事件数据，则可以转发布区域做的事件同步组件。3.3门禁对接常见问题与功能1、门禁权限开通要求：1、仅ISC1.3.0及以上版本支持。2、平台人员需先开卡，如果没有卡，则可以使用平台的虚拟卡功能。按以下步骤进行调用接口即可。第一步：添加权限配置备注：也可以穿插调用查询权限配置单进度，查看添加的权限是否生效(仅ISC1.4.100提供此接口)第二步：创建下载任务_根据出入权限配置下载第三步：添加待下载的设备通道_根据出入权限配置下载(使用第二步返回的taskID)第四步：开始下载任务(使用第二步返回的taskID)
密级级别：外部公开海康威视版权所有33ISC1.4.100以下平台，不支持页面查询通过接口下载的权限记录，只能通过接口去查询。ISC1.4.100可以通过以下界面查询所有的权限记录：2、获取人员门禁出入事件1)按时间段查询门禁事件，调用以下接口即可2)实时获取门禁人员出入事件参见3.2实时获取平台人员刷卡刷脸事情、车辆出入，单兵GPS位置事件等
密级级别：外部公开海康威视版权所有343、查询门禁设备状态，online返回为null查看巡检计划配置，将门禁状态设备检测状态设置为启用。3.4人员、组织、区域相关1、添加人员、组织、区域平台接口地址：https://open.hikvision.com/docs/8f684c68cbbc4a7bba86835e9f0659a7ISC1.4.100以下不允许自定义传入人员ID(personId)、组织ID、区域ID(regionIndexCode)
密级级别：外部公开海康威视版权所有35添加的人脸照片数据需要先使用人脸评分接口判断照片是否可用同时可以再通过获取人员图片接口，获取到人员图片的url，查看再浏览器中是否能够正常显示。
密级级别：外部公开海康威视版权所有362、获取人员图片1)通过接口先获取人员图片的url2)关闭ASW图片服务的认证关闭认证(默认是开启状态)
密级级别：外部公开海康威视版权所有373)拼装图片url将平台IP和固定端口6040(http)或端口6114(https),拼装到图片url即可。如以下示例：http://127.0.0.1:6040/pic?8dd285i5fe*30645743c125m3ep=t=i1p*i=d1s*i=d2b*i7da0*6a06ehttps://127.0.0.1:6114/pic?8dd285i5fe*30645743c125m3ep=t=i1p*i=d1s*i=d2b*i7da0*6a063、ISC1.4.100平台通过接口一个人员，平台展示三个相同人员。如下图解决方法：先连接irds数据库，删除多余重复的人员或者组织(出于安全角度，数据库操作仅限海康同事，不允许非海康同事进行操作)SELECT*FROMtb_orgWHEREorg_index_codeIN(SELECTa.org_index_codeFROMtb_orgaGROUPBYa.org_index_codeHAVINGCOUNT(a.org_index_code)>1);
密级级别：外部公开海康威视版权所有38SELECT*FROMtb_personWHEREperson_index_codeIN(SELECTa.person_index_codeFROMtb_personaGROUPBYa.person_index_codeHAVINGCOUNT(a.person_index_code)>1);安装以下补丁包：irds_hf_20200409202908_PN30354T_V1.3.100_解决irds1.3.100版本中管理接口问题.zipISC1.4.101相同处理方法。4、级联区域获取下级区域级联到上级区域，只能通过V2的接口获取到下级区域的信息。ISC1.3.0只支持查询区域列表v2这个接口。参数示例：{"resourceType":"region","pageNo":1,"pageSize":100}且不支持像查询区域一样给出树形结构关联关系。如下图：
密级级别：外部公开海康威视版权所有39ISC1.5.100支持通过根据区域编号获取下一级区域列表v2接口获取树形结构。3.5人脸评分接口常见问题返回：{"code":"0x1f91300f","msg":"uis.analyse.face.pic.download.fail","data":null}原因：再平台的服务器上无法访问传入的图片URL。解决方法：1、再平台的服务器上是否能够访问传入的图片URL。2、有内外网导致无法访问图片URL，可以将图片原始数据base64编码传入。
密级级别：外部公开海康威视版权所有40返回:{"code":"0x1f902302","msg":"algorithmlibraryisnotauthorized,pleasecheck","data":null}原因：人脸评分接口需要单独授权。解决方法：联系销售同事，让销售同事去申请授权即可。返回：能够调用成功，但多次调用返回0x0x1f902301分析：人脸评分接口使用是uis服务，目前该服务有性能瓶颈，一分钟最多能够调用12次左右。解决方法：1、开发新的接口，对接脸谱设备。2、提供uis服务的性能，目前已有项目做过，最高一分钟可以调用100次。可让行销或销售同事联系研发，提供方案。另：其它问题导致无法失败，请先认真看下人脸评分接口说明，看是否存在评分接口说明描述的问题。
密级级别：外部公开海康威视版权所有413.6获取4G移动设备GPS信息订阅事件：需先确认在图上监控里能看到位置信息事件中获取的经纬度需要除以36万，才是设备真实的经纬度。另：合作方获取到这个经纬度之后，如果需要这个经纬度在高德或百度地图上展示，除以36万之后，需要将原始84坐标转火星坐标(百度查转换方法)。转换之后和实际位置略有偏差，若需要减小偏差，可以查看如下设置的椭球长半轴，椭球的偏心率，圆周率常量值//圆周率PIprivatestaticfinaldoubleM_PI=Math.PI;//地球半径R乘以PIprivatestaticfinaldoublePI_R=20037508.34;//地球半径privatefinalstaticdoubleR=6378245.0;//对数常量eprivatefinalstaticdoubleE=0.00669342162296594323;
密级级别：外部公开海康威视版权所有423.7停车场常见问题调用车辆充值接口。返回：{“code”:“0X00052102”,“data”:null,“msg”:“ServiceError”}原因：平台停车场场景设置的是免费场景。调用取消包期接口返回：{"code":"0x02e13000","data":null,"msg":"pms.accountmanag.var.refund.failed"}原因：车还在停车场内，无法取消包期。Q：添加车辆无法指定车库，如果确定一辆车加入到指定的车库。A：在调用车辆充值接口，可以将车辆变成固定车，并指定车库。Q：访客的车辆是否按照预约时间进行管控。A：访客车辆入场是按照预约时间进行放行，出场是按照临时车进行处理，临时车如果设置收费，访客车辆则也需要收费。3.8合作方无法发送https请求或需重写认证ISC1.4.100以下平台支持http协议，1.4.100只支持https协议。平台设置http协议：
密级级别：外部公开海康威视版权所有43设置完成之后，即可用http协议登陆平台首页。端口也会变成http的端口。重写认证：说明：https://open.hikvision.com/docs/6a14a251f6d042319b277b26ad60aa17实例：3.9其它问题Q:单个接口获取的某些字段是空的，或者为空字符串？A:因为平台提供了一个开放性接口组件，部分字段为空，请找找该返回值里是否有某个唯一标识可以用来去调用别的接口获取到所需要的数据。ApiSignature.java
密级级别：外部公开海康威视版权所有44Q:客户问为什么数据不能一次性返回，几万条数据也需要分页？A:我们不是仅仅为了一家客户做的api接口，况且几万条数据一次返回组成的报文也是很大，请按照接口文档所介绍的，分页查询。当需要获取一些参数去测试的时候，请直接在api管理里搜“分页”，会有分页查询的接口显示，选择需要的接口进行测试，就可以获取到所需要的数据，接口调用不可能都是一个接口就能拿到所有的数据的，接口数据调用配合才能最终获取到所需要的完整的数据。这点，请客户对接方理解。如确实需要我方修改，请提交定制评估流程。Q、调用API接口，返回0X14c000161、平台版本是ISC1.3.0，重启api网关即可。2、平台版本是ISC1.3.100，建议放弃治疗，升级到ISC1.4.100如果无法升级则需要打核心服务补丁和api网关补丁。3、如果是行业平台，则检查一下行业平台的api资源包是否缺少插件包：
密级级别：外部公开海康威视版权所有45如果是缺少资源包，联系行业产品同事获取这个插件包。Q：调用平台接口返回code0X0240100错误Code:0X0240100msg:paramconverterror:ConsumerparamValueisnullA：使用的appkey和appsercet没有加上tagID，增加一个tagID即可(值填frs即可，参考对内合作方的配置)。Q:调用平台接口返回code0x0240100a错误{"code":"0x0240100a","msg":"paramconverterror：ConsumerparamValueisnull!"}A：使用的appkey和appsercet没有加上tagID，增加一个tagID即可(值填frs即可，参考对内合作方的配置)。Q：如何获取平台门禁事件图片、人员、停车场事件等图片A：通过接口或者解析事件报文中的图片url，然后关闭ASW认证，再通过拼装获取完整的图片url。详见：文档中3.4章节-->2、获取人员图片四、修订记录
密级级别：外部公开海康威视版权所有46序号变更时间版本变更人维护部门变更说明12019/10/31V1.0.0邵杨辉海康威视江苏研发中心创建22020/04/25V1.0.1张兵海康威视江苏研发中心新增人脸评分接口报错问题排查32020-04-26V1.0.2许北虎海康威视江苏研发中心新增视频问题42020/05/12V1.0.3张兵海康威视江苏研发中心修改文档层级结构，按照平台模块划分问题解答52020/05/13V1.0.4张兵海康威视江苏研发中心增加门禁事件获取人员唯一标识说明62020/05/14V1.0.5许北虎海康威视江苏研发中心增加视频预览问题72020/05/15V1.0.6张兵海康威视江苏研发中心增加获取人员图片82020/05/26V1.0.7陈建祥5海康威视江苏研发中心新增解决获取门禁设备状态返回字段为空的问题92020/06/04V1.0.8张兵海康威视江苏研发中心新增调用平台接口报错和播放视频自动断开问题。102020/07/13V1.0.9张兵海康威视江苏研发中心新增ISC1.4.100同步人员错误问题。112020/08/24V1.0.10张兵海康威视江苏研发中心新增级联区域获取问题122020/09/16V1.0.11张兵海康威视江苏研发中心增加GPS采集事件经纬度说明
密级级别：外部公开海康威视版权所有47132020/10/09V1.0.12张兵海康威视江苏研发中心增加停车场相关问题
郑重声明： 本文版权归原作者所有， 转载文章仅为传播更多信息之目的， 如作者信息标记有误， 请第一时间联系我们修改或删除， 多谢。