接口规范
<h3>一、通信协议</h3>
<p>接口遵循 REST 规范,使用 HTTP POST 方式进行通讯。<br />
标准协议的 HTTP 入口地址为:<br />
[对接方WMS接口地址]?method=[API名称]&&timestamp=[2015-02-01<br />
00:00:00]&format=xml&app_key=[erp_appkey]&v=2.0&sign=[签名]&sign_method=md5</p>
<h4>注:</h4>
<ol>
<li>[]中需要根据具体业务进行填写。API名称 具体见下方的 API 名称。</li>
<li>URL 需要做 URL Encoding 处理。</li>
<li>请求和响应的消息主体使用 XML 格式。</li>
</ol>
<h3>二、请求参数</h3>
<p>请求参数包含 URL 中带的系统参数和 BODY 中带的相关业务参数,系统参数如下:</p>
<table>
<thead>
<tr>
<th>参数</th>
<th>参数说明</th>
<th>类型</th>
<th>是否必须</th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>相关的业务接口名称,如商品信息同步的请求,method= bzy.connect.singleitem.synchronize</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>timestamp</td>
<td>时间戳,格式为 yyyy-mm-dd HH:mm:ss</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>format</td>
<td>content 格式,目前支持 XML,可直接填写xml</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>app_key</td>
<td>八爪云提供的对接应用的appkey</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>v</td>
<td>协议版本号,1.0 或者 2.0</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>sign</td>
<td>根据 url 和密钥计算的结果</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>sign_method</td>
<td>参数加密方法,md5</td>
<td>string</td>
<td>是</td>
</tr>
</tbody>
</table>
<p>三、响应参数</p>
<p>响应参数包含系统参数和业务参数,系统参数如下:</p>
<table>
<thead>
<tr>
<th>参数</th>
<th>参数说明</th>
<th>类型</th>
<th>是否必须</th>
</tr>
</thead>
<tbody>
<tr>
<td>flag</td>
<td>success或failure</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>code</td>
<td>返回状态码</td>
<td>string</td>
<td>是</td>
</tr>
<tr>
<td>message</td>
<td>返回状态描述</td>
<td>string</td>
<td>是</td>
</tr>
</tbody>
</table>