获取令牌
<h5>简要描述</h5>
<ul>
<li>企业调用接口前,先要获取用户身份令牌(access_token)</li>
</ul>
<h5>请求方式</h5>
<ul>
<li><code>HTTP POST</code></li>
</ul>
<h5>请求格式</h5>
<ul>
<li><code>URL</code></li>
</ul>
<h5>请求地址</h5>
<ul>
<li><code>获取token地址:https://ip:端口/yspt/token</code></li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">org_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>项目代码</td>
</tr>
<tr>
<td style="text-align: left;">serve_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>注册码</td>
</tr>
<tr>
<td style="text-align: left;">auth_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>授权码</td>
</tr>
<tr>
<td style="text-align: left;">signature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>数据签名 HMACSHA256(data,签名密钥) ,算法和签名密钥向服务商索取。<a href="https://www.showdoc.com.cn/p/60277703342cb81412d3785f1bbf15aa">点我查看token签名JAVA版</a></td>
</tr>
</tbody>
</table>
<h5>响应参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">返回</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回代码</td>
</tr>
<tr>
<td style="text-align: left;">info</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>错误描述</td>
</tr>
<tr>
<td style="text-align: left;">access_token</td>
<td style="text-align: left;">成功时返回</td>
<td style="text-align: left;">string</td>
<td>令牌</td>
</tr>
<tr>
<td style="text-align: left;">token_endtime</td>
<td style="text-align: left;">成功时返回</td>
<td style="text-align: left;">String</td>
<td>令牌失效时间</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-java">String url=http://${host}:${port}/${ctx}/token;
String org_code;
String serve_code;
String auth_code;
String secret;
String param=(&quot;org_code=&quot;+org_code);
param+=(&quot;&amp;serve_code=&quot;+serve_code);
param+=(&quot;&amp;auth_code=&quot;+auth_code);
param+=(&quot;&amp;signature=&quot;+HMACSHA256(param,secret));
http.request(url+&quot;?&quot;+param);</code></pre>
<h5>返回示例</h5>
<pre><code>//正确返回
{
&quot;access_token&quot;: &quot;KMdNrA3L7vWEmDMUC18XRfPnM1Y4Ed5H&quot;,
&quot;code&quot;: 200,
&quot;token_endtime&quot;: &quot;2023-08-12 00:00:00&quot;
}
//错误返回
{
&quot;code&quot;:601001,
&quot;info&quot;:&quot;项目代码不存在!&quot;
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功</td>
</tr>
<tr>
<td>601001</td>
<td>项目代码不存在</td>
</tr>
<tr>
<td>601002</td>
<td>授权码错误</td>
</tr>
<tr>
<td>601003</td>
<td>注册码错误</td>
</tr>
<tr>
<td>601004</td>
<td>数据签名错误</td>
</tr>
</tbody>
</table>