开放平台

电话咨询 400-000-7749

QQ咨询
  • 开放API常见问题答疑

  • 更新时间:2024-06-28

    1.1 怎么获取接口中的 域名,appId和appKey


  • 请咨询业务人员获取，其中一个银豹账号对应一个appId和appKey


    1.2 报错:找不到适合的IdentityValidator


  • 请求json中，没有appId (区分大小写)


    1.3 报错:消息体与消息签名不匹配


  • 请求头data-signature 计算有误


    1.4 报错:参数不匹配


  • 请求体格式为json格式的字符串，比如{"appId":"mylinl1","productUid":6666}
  • 而不是 form-data,x-www-from-urlencoded


    1.5 返回内容乱码


  • 返回内容有可能是gzip压缩过的。客户端调用人员根据response header 中的Content-Encoding自行解压。(有返回gzip,就用gzip解压，没有的话，无需处理)


    1.6 关于连锁


  • 开放平台是以门店为维度的，获取哪家门店的销售单据，商品 等信息，就用哪家门店的appId,而不是用总部的
  • 结论:通过总部门店的appId,无法获取子门店的数据（会员除外）


    1.7 精度丢失


  • 接口中uid 如productUid,ticketUid,customerUid,cashierUid等 是bigIntger类型。
  • php,js 等语言会出现精度丢失问题（eg:后2位都变成00），自行百度下解决方案

  • 比如：分页查询全部商品信息，返回了某个商品的uid为 1718695829311543300
  • 但根据商品uid却查不到商品数据
  • 可能原因: 1718695829311543300 这个是精度丢失后的数据
  • 真实的uid 可能是17186958293115433xx


    1.8 分页查询(比如 分页查询全部商品信息,分页查询销售单据 等分页接口)


  • 每页固定返回100条数据,当返回的数据小于pageSize(100)时，表示最后一页