数电发票开具前置接口

云税平台开票前置接口规范


获取令牌

<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=(&amp;quot;org_code=&amp;quot;+org_code); param+=(&amp;quot;&amp;amp;serve_code=&amp;quot;+serve_code); param+=(&amp;quot;&amp;amp;auth_code=&amp;quot;+auth_code); param+=(&amp;quot;&amp;amp;signature=&amp;quot;+HMACSHA256(param,secret)); http.request(url+&amp;quot;?&amp;quot;+param);</code></pre> <h5>返回示例</h5> <pre><code>//正确返回 {     &amp;quot;access_token&amp;quot;: &amp;quot;KMdNrA3L7vWEmDMUC18XRfPnM1Y4Ed5H&amp;quot;,     &amp;quot;code&amp;quot;: 200,     &amp;quot;token_endtime&amp;quot;: &amp;quot;2023-08-12 00:00:00&amp;quot; } //错误返回 { &amp;quot;code&amp;quot;:601001, &amp;quot;info&amp;quot;:&amp;quot;项目代码不存在!&amp;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>

页面列表

ITEM_HTML