• REST风格的API，使用HTTPS协议发送POST请求调用接口。

• HTTPS请求头类型为 Content-Type: application/x-www-form-urlencoded

2. 报文及报文编码

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

• 请求报文用键值对的形式通过 & 拼接后放在body里，格式类似这样 key=1&key={“xx”:”1″}&key=[{“xx”:”1″}]形式，要用post的方式发送，不要用get拼接在url后边。

• 为了保证传输数据的安全性，API采用了对称加密的方式，旺店通开放平台会为每个接入客户分配appkey和appsecret，通过计算sign（签名）来防止恶意的数据篡改，具体的sign计算方式请参考 “sign算法” 文档

• 编码示例：key=urlencode(value)&key=urlencode(value) urlencode() 为进行编码的方法。（每个语言的编码函数可能不同，请开发者自主选择具体的url编码方式）。

• 注意：appsecret不要作为请求参数发送到互联网中。

• 注意：旺店通ERP存在商品明细的单据中可以存在多行商家编码一样的商品，如果对接的系统不支持此情况，需进行合并处理。

3. 接口文档说明

3.1 接口说明

• 用于接口描述、接口级别注意事项、敏感数据，以及建议调用方式等。

3.2 调用场景

• 用于说明接口适用对接的系统。
  

3.3请求参数说明

• 描述了请求报文所有输入参数的含义及注意事项。

3.3.1 请求地址（url）

• 接口文档该部分描述了每个接口的测试和正式环境请求地址，注：不同接口变更“接口服务名”即可。

       1）测试环境：https://sandbox.wangdian.cn/openapi2/接口服务名

       2）正式环境：https://api.wangdian.cn/openapi2/接口服务名

3.3.2 公共请求参数

• 每个接口都必须输入的参数。接口文档该部分阐述了请求报文中公共请求参数的含义及注意事项，参数详见下述表格。

• 注：appsecret作为校验数据安全使用，不要将它作为公共参数传输到互联网中。

3.3.3 业务请求参数

• 可根据业务不同，选择输入的参数。接口文档该部分阐述了请求报文中业务请求参数的含义及注意事项。

4 .1响应参数

• 接口文档该部分描述了所有响应参数的含义及注意事项
  

  1）公共响应参数

• 接口文档该部分描述了，请求的当前接口，不论请求失败还是成功，一定会返回的参数，文档该部分描述了公共响应参数的含义。
  

  2）业务响应参数

• 根据请求的参数输入值不同，做不同响应的参数，文档该部分描述了业务响应参数的含义

3.3.5 请求示例

• 调用接口的请求示例，有PHP、JAVA、C#三种示例。

3.3.6 响应示例

• 调用接口后返回的json格式数据 ，需要使用json解析函数进行解析，使用Unicode转换具体的字段含义解释，并且给出了正常响应和异常响应两种响应示例。

4. 接口流量及调用频率限制

 4.1 流量限制

• 限制条件：sid+appkey+接口

• 限制规则：100万次/日

• 涉及接口：所有接口
  

 4.2 频率限制

• 限制条件：sid+appkey+单独接口

• 涉及接口：所有接口
  

• 限制规则：

         ①仅限制并发量：并发量是指调用开放平台API接口允许同时请求的线程个数。

         ②同时限制并发量和调用频率：调用频率旺店通企业版开放平台的定义为每分钟允许请求的次数。

• 限制说明详情如下

基础类

货品类

订单类

售后类

采购类

库存类