调用方式说明

  • REST风格的API,使用HTTP协议发送POST请求调用接口。
  • 消息报文用键值对的形式放在body里,要用post的方式发送,不要用get拼接在url后边。
  • 发送请求消息时要对键值对里的值进行URL编码,不要直接对post内容进行编码,而是需要循环对每个值单独url编码。
  • 特别注意下 body里的数据格式类似这样 key=1&key={“xx”:”1″}&key=[{“xx”:”1″}]形式,而不是整个json。

数据类型:

  • Content-Type: application/x-www-form-urlencoded

字符编码

  • UTF8编码
  • 支持半角 中文 英文 数字 基本标点符号
  • 请注意不要有表情符号等各种非法字符,会导致数据库写入失败。

注意事项

  1. 请把所有请求参数放到post请求列表里.也就是消息报文的body里.
  2. 传输的数据需要对值进行url编码,否则对于+号等符号会解析错误,导致签名验证失败。
    编码示例:key=urlencode(value)&key=urlencode(value)
    *urlencode() 为进行编码的方法。
  3. 签名计算在前,url编码在后,切勿先编码后算签名。
  4. 商品明细中可以存在多行商家编码一样的商品,如果对接的系统不支持此情况,需要进行合并处理。

公共参数(系统级别参数)

  • sid 购买ERP时由旺店通分配给ERP的用户。对接的技术如果需要此参数,请从ERP用户处获取(即卖家)。

  • appkey 由商务(销售)人员通过申请获取,使用接口必须要此参数,请联系旺店通的商务人员申请分配。

  • timestamp,调用接口时的时间戳,秒级的10位int值,有效时间为5分钟,服务器时间需要跟标准时间校准。date.timezone = Asia/Shanghai

  • sign: API输入参数签名结果,签名算法介绍单击这里

常见问题

Q:无效的sid。
A:一般是请求参数传过来的格式错误,导致接口获取不到sid参数。

Q:无效的时间戳。
A:获取不到时间戳参数,请检查拼写,或者是服务器时间不准确需要校准服务器时间。

Q:某些接口报没有权限,或者缺少某些店铺和仓库的数据。
A:主要原因是admin账号的权限没有设置,需要给admin账号设置所有的店铺和仓库的权限。

Print Friendly, PDF & Email