Web服务说明
<p>1、ITRS接口遵循Restfull设计规范,所有接口返回值均为统一格式。本文档中的HTTP谓语词:POST新增、PUT修改、GET获取、DELETE删除。
2、涉及到新增和修改操作时,请发送JSON类型的请求正文,并标示请求正文的类型为:Content-Type: "application/json;charset:utf-8";
3、关于接口授权,为简化客户端与服务端之间的授权流程,服务端要求客户端按照以下方式传入授权参数:
3.1 在请求头中【Header】传入固定参数,Key:Authorization,Value:Bearer token
3.1、token值计算规则:请将当前(UTC)年月日时分使用MD5 32位加密即可。例如:202206231514,注意精确到分即可,因此接口调用时要求客户端与服务器端时间误差不能超过1分钟。</p>
<ul>
<li>Code对照,类型为int 数值,所有返回值如下:</li>
</ul>
<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;">301</td>
<td>要求客户端重定向</td>
</tr>
<tr>
<td style="text-align: left;">401</td>
<td>接口授权失败,一般为没有传递授权相关参数。</td>
</tr>
<tr>
<td style="text-align: left;">403</td>
<td>服务器拒绝处理,一般为授权参数传入有误,服务器认证失败。</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td>请求路径不存在</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td>服务器处理异常,此时可根据返回的错误消息,调整传入的参数。</td>
</tr>
<tr>
<td style="text-align: left;">503</td>
<td>服务器异常,此时只能联系服务器管理员。</td>
</tr>
</tbody>
</table>
<ul>
<li>授权参数传递,POST MAIN
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=b01e75150ffa11082baf6c812a012e8b" alt="" /></li>
</ul>