7. 常见问题答疑

7.1. 接口地址

接口对接共三种方式，请根据自己的方式选择对应的地址

以上是各种类型的服务根目录，后面的服务路径请根据文档中的路径进行拼接。 * 商业客流云平台中的广场和连锁客流云平台中的门店是同一概念。

7.2. 如何获取接口所需的atoken

atoken是调用【基础信息接口】-【登录接口】 api/v1/user/login 接口，传入用户名、密码获取的。

7.3. 账号密码是多少

账号密码是项目交付时提供的信息。与登录平台使用的用户名密码一致。

7.4. 如何获取客流数据

  • 先从项目组（管理员）获取账户信息。
  • 调用登录接口，获取atoken
  • 调用【基础信息】-【门店（广场）信息列表】接口，获取门店（广场）的信息，或记录unid字段。以备后续调用接口传参。
  • 如果需要调用区域、店铺、楼层、监控点客流数据，则需要继续调用【基础信息】下其他相应的接口，并做记录。
  • 调用【传统客流数据接口】-【门店数据】下指定的接口，获取门店（广场）不同类型的客流数据。
  • 客流数据按统计时间粒度区分为：天级客流（以天为单位统计）、小时级客流、分钟级客流。

7.5. 什么是增量xx客流

系统在做实时客流同步时，考虑到各种因素可能会造成数据延迟。为了确保延迟的数据也能够被外部系统收到，接口可以支持按modifytime时间获取。

譬如：第一次获取接口返回的数据集合中，modyfitime的最大值为2020-01-01 12:00:00，

那么通过增量接口下次获取数据的时候传入参数modifytime， 接口会返回所有在modifytime之后更新过的数据。包括实时数据和历史延迟数据都会返回。

接收到数据之后再次记录最大的modifytime，依次类推，便可确保延迟数据也能被调取。

如此，便是增量客流接口。

7.6. 返回atoken无效怎么办

重新调用登录接口获取atoken。

客户端调用应做atoken无效的检测，atoken失效后自动调用登录接口，更新atoken。

7.7. atoken的有效期是多久

不一定。会根据实际情况动态调整。

7.8. 提示atoken无效怎么回事

  • 先确认atoken是不是在http的header里设置的。
  • 检查参数的名称，参数名按照接口要求是：authorization
  • 试着重新调用登录接口，更新atoken值

7.9. 程序调用失败怎么办

  • 先使用postman或者其他接口调试工具，按照文档要求的地址、参数等相关的进行测试调用。
  • 如果使用工具调用失败，请检查参数类型、地址，特别是atoken相关的参数。参考上一章节。
  • 如果经过各种检查，使用工具仍然调用失败。请记录返回的失败信息，与项目经理联系。
  • 如果使用工具调用成功，但是程序失败。请检查自己的调用程序。