对接规范
<p>[TOC]</p>
<h5>接口方式</h5>
<ul>
<li>接口调用采用http协议,restful请求方式;</li>
</ul>
<h5>接口地址</h5>
<ul>
<li><a href="https://rxcj.gtgbxy.cn/open">https://rxcj.gtgbxy.cn/open</a></li>
</ul>
<h5>接口安全</h5>
<ul>
<li>接口安全采用Json web token (JWT)机制,基于token的鉴权机制.</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET、POST、PUT、DELETE</li>
</ul>
<h5>认证方式</h5>
<ul>
<li>
<p>方式一: 除认证接口,其他所有请求的头(Headers)都需要携带参数authorization(授权令牌 由认证接口返回),token有效期为4小时,如果请求返回http状态为401,说明认证失效了,请重新请求认证接口获取新的token。</p>
<p>authorization的格式是:<code>authorization:&lt;type&gt; &lt;token&gt;</code>
如token为:</p>
<pre><code>eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3Q6ODAwMFwvb3BlblwvYXV0aCIsImlhdCI6MTcwNDk3ODAzNiwiZXhwIjoxNzA0OTkyNDM2LCJuYmYiOjE3MDQ5NzgwMzYsImp0aSI6ImFBckxDUmZuemtlR0JZMjciLCJzdWIiOjEsInBydiI6ImRlMGQ2MzYzZjZhN2Y5MTI1ZmQzMjM3ZGJmMDc3ZjU3Y2MxM2YzODMifQ.QD3s9uNFpUa_ja2QBTX5BOVxXpPqkA_uOf3bTIISlzc</code></pre>
<p>则authorization为:</p>
<pre><code>bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9sb2NhbGhvc3Q6ODAwMFwvb3BlblwvYXV0aCIsImlhdCI6MTcwNDk3ODAzNiwiZXhwIjoxNzA0OTkyNDM2LCJuYmYiOjE3MDQ5NzgwMzYsImp0aSI6ImFBckxDUmZuemtlR0JZMjciLCJzdWIiOjEsInBydiI6ImRlMGQ2MzYzZjZhN2Y5MTI1ZmQzMjM3ZGJmMDc3ZjU3Y2MxM2YzODMifQ.QD3s9uNFpUa_ja2QBTX5BOVxXpPqkA_uOf3bTIISlzc</code></pre>
</li>
<li>方式二: 除认证接口,其他所有请求必须携带参数token(授权令牌 由认证接口返回),token有效期为4小时,如果请求返回http状态为401,说明认证失效了,请重新请求认证接口获取新的token</li>
</ul>
<h5>返回code说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td>接口请求成功</td>
</tr>
<tr>
<td style="text-align: left;">401</td>
<td>接口认证失败</td>
</tr>
</tbody>
</table>