开发约定
<h3>请求前缀地址</h3>
<p><code>https://2025vip.haswallow.com/merchant-api</code></p>
<hr />
<h3>自定义数据头</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">关键字</th>
<th>说明</th>
<th>示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Authorization</td>
<td>身份校验令牌</td>
<td>e47085904e8302d6c48fc566cc43b5ef</td>
</tr>
<tr>
<td style="text-align: left;">X-CSRF-TOKEN</td>
<td>表单令牌</td>
<td>b104d12a9fd24d0782bcbf7bd932e42d</td>
</tr>
</tbody>
</table>
<ul>
<li>表单令牌获取后时效为1小时,失效后返回code=40406</li>
<li>每个表单令牌只允许被使用一次(双击重复提交),已被使用的表单令牌返回code=40409</li>
</ul>
<hr />
<h3>请求方法(method)</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">method</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">GET[资源获取]</td>
</tr>
<tr>
<td style="text-align: left;">POST[资源创建/更新/删除]</td>
</tr>
</tbody>
</table>
<h3>请求数据类型(content type)</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">数据类型</th>
<th>请求方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">url-params</td>
<td>GET</td>
</tr>
<tr>
<td style="text-align: left;">multipart/form-data</td>
<td>POST[仅文件上传]</td>
</tr>
<tr>
<td style="text-align: left;">application/json</td>
<td>POST</td>
</tr>
</tbody>
</table>
<h3>返回通用格式结构</h3>
<pre><code>{
&quot;code&quot;: 0,//状态码
&quot;message&quot;: &quot;消息文本&quot;,
&quot;data&quot;: 数据内容
}</code></pre>
<h3>全局code状态码:</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">code</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">1</td>
<td>失败</td>
</tr>
<tr>
<td style="text-align: left;">40110</td>
<td>登录失效/未登录</td>
</tr>
<tr>
<td style="text-align: left;">40200</td>
<td>数据校验失败</td>
</tr>
<tr>
<td style="text-align: left;">50500</td>
<td>服务器异常</td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">关键字</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Trace-Id</td>
<td>链路追踪id</td>
</tr>
<tr>
<td style="text-align: left;">Request-Datetime</td>
<td>请求时间</td>
</tr>
</tbody>
</table>