2. 开发前必读 - 如何获取Token
<p>[TOC]</p>
<h1>如何获取Token</h1>
<h2>开放平台申请appid和密钥</h2>
<pre><code>开发期间，暂时联系产业园项目组研发（曾远征），由管理人员进行开通和分配appid、密钥和开放平台账号</code></pre>
<h2>获取tonken</h2>
<p>请先阅读签名篇，否则可能无法进行后续的开发</p>
<h3>请求URL</h3>
<ul>
<li><code>http://ip:port/open/auth</code></li>
</ul>
<h3>请求方式</h3>
<ul>
<li>POST </li>
</ul>
<h3>Header 参数</h3>
<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;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开放平台分配的appid</td>
</tr>
</tbody>
</table>
<h3>Body 参数</h3>
<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;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方平台的用户ID</td>
</tr>
<tr>
<td style="text-align: left;">userType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>1: 学生 （暂时只有学生）</td>
</tr>
<tr>
<td style="text-align: left;">username</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户名称</td>
</tr>
<tr>
<td style="text-align: left;">avatar</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户头像，url地址</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>手机号，主要用于后续短信通知等相关涉及手机号的功能</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名</td>
</tr>
</tbody>
</table>
<h3>请求示例</h3>
<pre><code>{
&quot;avatar&quot;: &quot;http://124.225.163.144:9800/open/2f23b21945407f504e8560ecc146997c60717788020c846408fc2157e35b709a.png&quot;,
&quot;phone&quot;: &quot;17666531991&quot;,
&quot;sign&quot;: &quot;9b48b63c2b20ebeab66d9e71d13b8172&quot;,
&quot;timestamp&quot;: 1705829597,
&quot;userId&quot;: &quot;1002376&quot;,
&quot;userType&quot;: 1,
&quot;username&quot;: &quot;曾远征&quot;
}</code></pre>
<h3>返回示例</h3>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: &quot;eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwaG9uZSI6IjE3NjY2NTMxOTkxIiwiZXhwaXJlX3RpbWUiOjE3MDcxMjU2MTI5NzcsInVzZXJUeXBlIjoxLCJhdmF0YXIiOiJodHRwOi8vMTI0LjIyNS4xNjMuMTQ0Ojk4MDAvb3Blbi8yZjIzYjIxOTQ1NDA3ZjUwNGU4NTYwZWNjMTQ2OTk3YzYwNzE3Nzg4MDIwYzg0NjQwOGZjMjE1N2UzNWI3MDlhLnBuZyIsInVzZXJOYW1lIjoi5pu-6L-c5b6BIiwidXNlcklkIjoiMTAwMjM3NiJ9.E727miO8lHQeEsacVm4rcW3VE_svuh_OxlRJMQVS5CQ&quot;,
&quot;msg&quot;: &quot;&quot;
}</code></pre>
<h3>返回参数说明</h3>
<table>
<thead>
<tr>
<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;">int</td>
<td>0为成功，非0为不成功</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>令牌</td>
</tr>
</tbody>
</table>
<h3>备注</h3>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>