海康云眸对接指南

1. 适用范围

本文适用于需要通过观远数据连接器同步海康云眸客流数据的客户。当前连接器平台为“海康云眸”，平台编码为 HIK_CLOUD，认证方式为账号密钥类认证。

连接器目前支持“查询客流数据”，用于同步门店小时级客流明细，包括入客流、出客流、经过客流、门店信息和数据入库时间等字段。

2. 申请平台对接资质

2.1 确认海康云眸账号和接口权限

请使用客户自己的海康云眸管理员账号或具备开放接口申请权限的账号，向海康云眸官方或客户的海康服务人员申请开放接口对接资质。申请时说明需要通过观远数据读取海康云眸客流数据，用于经营分析、门店客流分析或数据看板。

申请时请明确需要开通客流相关接口权限。连接器调用的客流接口为海康云眸开放接口中的客流明细分页查询能力，可参考海康云眸官方接口文档；对应接口地址为 https://api2.hik-cloud.com/v1/customization/passengerFlow/detailsPage。

2.2 获取 clientId 和 clientSecret

海康云眸侧完成开放接口资质开通后，请从海康云眸官方返回的应用或接口凭证中保存以下字段：

请确认 clientId 和 clientSecret 来自同一个海康云眸应用、租户或接口账号，并且该应用已开通客流数据查询权限。不要混用测试环境和正式环境的凭证。

2.3 填写前检查

填写到观远连接器前，请检查字段值没有多余空格、换行或中文引号。clientSecret 属于敏感信息，不要在文档、聊天记录或截图中明文传播。

3. 创建连接器数据账户

3.1 打开数据账户创建页面并选择平台

登录观远数据连接器平台，进入“数据账户管理”，点击“新增数据账户”，所属平台选择“海康云眸”。

3.2 字段映射关系

3.3 填写、测试连接并保存

填写账户名称、clientId 和 clientSecret 后，点击“测试连接”。测试通过后保存数据账户。后续创建或执行“查询客流数据”接口任务时，选择该海康云眸数据账户即可。

4. 常见问题