验证登录user_token是否有效
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>验证登录user_token是否有效
验证user_token是否为有效的登录用户会话，若有效则返回其账号标识、账号创建者和昵称。"游戏客户端"通过"SDK 客户端"获取到user_token，传到"游戏服务器"，"游戏服务器"到"SDK 服务器"验证user_token的有效性。
注意：进行接口调用前请确认user_token是否具备值，如user_token值为空时请勿调用此接口。请求次数有限制，如果超过频次限制，接口将返回错误码，不响应请求。</li>
</ul>
<h5>请求URL（见SDK服务器接口说明/概述）</h5>
<h5>请求方式</h5>
<ul>
<li>POST Content-Type: application/json;</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;">app_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>必须游戏接入时分配的应用app_id</td>
</tr>
<tr>
<td style="text-align: left;">mem_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>mem_id登陆时提供给CP的用户ID</td>
</tr>
<tr>
<td style="text-align: left;">user_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登陆获取的user_token</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>
<h5>请求示例 (POST Content-Type: application/json)</h5>
<pre><code> {
&quot;app_id&quot;:&quot;1&quot;,
&quot;mem_id&quot;:&quot;23&quot;,
&quot;user_token&quot;: &quot; rkmi2huqu9dv6750g5os11ilv2&quot;,
&quot;sign&quot;:&quot;4753dce3ae736e7f894ebcc6cd3cff7a&quot;
}
假定app_key= de933fdbede098c62cb309443c3cf251
sign 的签名规则：md5(app_id=...&amp;mem_id=...&amp;user_token=...&amp;app_key=...)
(替换...为实际值)
签名原文：
app_id=1&amp;mem_id=23&amp;user_token=rkmi2huqu9dv6750g5os11ilv2&amp;app_key=de933fdbede098c62cb309443c3cf251
sign=md5(app_id=1&amp;mem_id=23&amp;user_token=rkmi2huqu9dv6750g5os11ilv2&amp;app_key=de933fdbede098c62cb309443c3cf251)
md5加密：
echo -n &quot;app_id=1&amp;mem_id=23&amp;user_token=rkmi2huqu9dv6750g5os11ilv2&amp;app_key=de933fdbede098c62cb309443c3cf251&quot;|md5sum
加密结果：4753dce3ae736e7f894ebcc6cd3cff7a</code></pre>
<h5>返回示例 (json)</h5>
<pre><code> {
&quot;status&quot;:&quot;1&quot;,
&quot;msg&quot;:&quot;用户已登陆&quot;
}</code></pre>
<h5>返回参数说明</h5>
<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;">status</td>
<td style="text-align: left;">int</td>
<td>状态码</td>
</tr>
<tr>
<td style="text-align: left;">msg </td>
<td style="text-align: left;">String</td>
<td>状态码说明</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td>请求参数错误</td>
</tr>
<tr>
<td style="text-align: left;">1 </td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">10 </td>
<td>服务器内部错误</td>
</tr>
<tr>
<td style="text-align: left;">11 </td>
<td>app_id错误</td>
</tr>
<tr>
<td style="text-align: left;">12 </td>
<td>签名错误</td>
</tr>
<tr>
<td style="text-align: left;">13 </td>
<td>user_token错误</td>
</tr>
<tr>
<td style="text-align: left;">14 </td>
<td>user_token超时，登录授权已超时，需引导用户重新登录，并更新接口访问令牌。（注：访问令牌的有效时长是1天）</td>
</tr>
<tr>
<td style="text-align: left;">15 </td>
<td>mem_id错误</td>
</tr>
<tr>
<td style="text-align: left;">16 </td>
<td>访问太频繁，超过访问次数</td>
</tr>
<tr>
<td style="text-align: left;">100 </td>
<td>没有接口访问权限（注：出现时可联系技术人员确认权限是否开通）</td>
</tr>
</tbody>
</table>