开发必读
<p>[toc]</p>
<h1>开发必读</h1>
<p>特别说明:<strong>不需要的字段请不要传null值,请将null值字段忽略掉。</strong></p>
<h2>申请接口资料说明</h2>
<p>在云帆ERP系统店铺管理下的外部接口申请页面中填写相关信息后申请接口权限。填写完成后,联系客服进行审核。
<strong>特别说明:</strong>此文档仅针对推送到云帆的接口。</p>
<h2>数据格式定义</h2>
<ul>
<li>数据编码采用UTF-8格式,application/json格式</li>
<li>
<h2>采用HTTP或HTTPS传输协议,POST方法</h2>
<h2>接口必须参数</h2>
</li>
</ul>
<h3>Headers必须参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">空</th>
<th>默认</th>
<th>注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>签名,MD5(app_id + PostBody + appSecret)</td>
</tr>
</tbody>
</table>
<p>将请求的结构体转json后,进行MD5签名,签名字符串放在请求<strong>Header</strong>中</p>
<h3>PostBody数据必须字段</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">字段</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">空</th>
<th>默认</th>
<th>注释</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">app_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>系统中申请的app_id</td>
</tr>
<tr>
<td style="text-align: left;">msg_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td></td>
<td>消息id,请保证唯一性,重复id不处理</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">否</td>
<td>0</td>
<td>当前请求时间戳(毫秒)</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">否</td>
<td>null</td>
<td>参考各个接口相应传输数据结构体</td>
</tr>
</tbody>
</table>
<h1>开发说明</h1>
<ol>
<li>系统支持设置访问<strong>IP</strong>白名单,可在外部接口申请中设置。</li>
<li>每次请求的时间戳务必使用当前时间戳。</li>
<li>签名格式为MD5(app_id + PostBody + appSecret)转小写,其中appSecret是外部接口申请的页面中查看。</li>
<li><strong>msg_id</strong> 请保证唯一性,否则将不进行处理,并返回错误。</li>
</ol>