开发文档
<h1>鹿小檬开发文档</h1>
<h2>一、概述</h2>
<p>鹿小檬允许用户借助第三方平台（如QQ、微信、微博、百度等）已有的账号，快速完成应用的登录流程。通过本站提供的聚合登录接口，开发者能够获取用户信息和授权信息，接口遵循OAuth2.0身份鉴权机制。</p>
<h2>二、接口协议规则</h2>
<ol>
<li><strong>传输方式</strong>：HTTP</li>
<li><strong>数据格式</strong>：JSON</li>
<li><strong>字符编码</strong>：UTF-8</li>
</ol>
<h2>三、登录流程</h2>
<h3>（一）获取跳转登录地址</h3>
<ol>
<li><strong>请求URL</strong>：<code>https://login.lmwa.cn/connect.php?act=login&amp;appid={你的appid}&amp;appkey={你的appkey}&amp;type={登录方式}&amp;redirect_uri={返回地址}</code></li>
<li><strong>请求参数说明</strong>
<ul>
<li><strong>appid</strong>：开发者在平台申请的应用ID。</li>
<li><strong>appkey</strong>：与appid对应的应用密钥，用于验证请求合法性。</li>
<li><strong>type</strong>：指定登录使用的第三方平台，对应值如下表：</li>
</ul></li>
</ol>
<table>
<thead>
<tr>
<th>对应值</th>
<th>登录方式名称</th>
</tr>
</thead>
<tbody>
<tr>
<td>qq</td>
<td>ＱＱ</td>
</tr>
<tr>
<td>wx</td>
<td>微信</td>
</tr>
<tr>
<td>alipay</td>
<td>支付宝</td>
</tr>
<tr>
<td>baidu</td>
<td>百度</td>
</tr>
<tr>
<td>huawei</td>
<td>华为</td>
</tr>
<tr>
<td>xiaomi</td>
<td>小米</td>
</tr>
<tr>
<td>microsoft</td>
<td>微软</td>
</tr>
<tr>
<td>dingtalk</td>
<td>钉钉</td>
</tr>
<tr>
<td>gitee</td>
<td>Gitee</td>
</tr>
<tr>
<td>github</td>
<td>GitHub</td>
</tr>
</tbody>
</table>
<pre><code>- **redirect_uri**：用户登录成功或失败后，跳转回开发者应用的指定地址。</code></pre>
<ol>
<li><strong>返回格式</strong></li>
</ol>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;succ&quot;,
&quot;type&quot;: &quot;qq&quot;,
&quot;url&quot;: &quot;https://graph.qq.com/oauth2.0/XXXXXXXXXX&quot;
}</code></pre>
<ol>
<li><strong>返回参数说明</strong></li>
</ol>
<table>
<thead>
<tr>
<th>参数名</th>
<th>参数类型</th>
<th>参数说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>int</td>
<td>返回状态码，0为成功，其它值为失败</td>
<td>0</td>
</tr>
<tr>
<td>msg</td>
<td>string</td>
<td>返回信息，返回错误时的说明</td>
<td>succ</td>
</tr>
<tr>
<td>type</td>
<td>string</td>
<td>登录方式</td>
<td>qq</td>
</tr>
<tr>
<td>url</td>
<td>string</td>
<td>登录跳转地址</td>
<td><a href="https://graph.qq.com/oauth2.0/XXXXXXXXXX">https://graph.qq.com/oauth2.0/XXXXXXXXXX</a></td>
</tr>
<tr>
<td>qrcode</td>
<td>string</td>
<td>登录扫码地址，仅微信和支付宝返回</td>
<td>-</td>
</tr>
</tbody>
</table>
<h3>（二）跳转到登录地址</h3>
<p>将上一步返回的<code>url</code>值作为跳转地址，引导用户前往第三方平台进行登录操作。</p>
<h3>（三）登录成功回调</h3>
<p>登录成功后，系统会自动跳转到指定的<code>redirect_uri</code>，并在URL中附带<code>Authorization Code</code>。例如，若回调地址为<code>www.qq.com/my.php</code>，则跳转地址为<code>http://www.qq.com/my.php?type=qq&amp;code=520DD95263C1CFEA0870FBB66E******</code>。</p>
<h3>（四）通过Authorization Code获取用户信息</h3>
<ol>
<li><strong>请求URL</strong>：<code>https://login.lmwa.cn/connect.php?act=callback&amp;appid={appid}&amp;appkey={appkey}&amp;type={登录方式}&amp;code={code}</code></li>
<li><strong>请求参数说明</strong>
<ul>
<li><strong>appid</strong>、<strong>appkey</strong>、<strong>type</strong>：同获取跳转登录地址时的参数含义。</li>
<li><strong>code</strong>：登录成功回调时获取的<code>Authorization Code</code>。</li>
</ul></li>
<li><strong>返回格式</strong></li>
</ol>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;succ&quot;,
&quot;type&quot;: &quot;qq&quot;,
&quot;access_token&quot;: &quot;89DC9691E274D6B596FFCB8D43368234&quot;,
&quot;social_uid&quot;: &quot;AD3F5033279C8187CBCBB29235D5F827&quot;,
&quot;faceimg&quot;: &quot;https://thirdqq.qlogo.cn/g?b=oidb&amp;k=3WrWp3peBxlW4MFxDgDJEQ&amp;s=100&amp;t=1596856919&quot;,
&quot;nickname&quot;: &quot;大白&quot;,
&quot;location&quot;: &quot;XXXXX市&quot;,
&quot;gender&quot;: &quot;男&quot;,
&quot;ip&quot;: &quot;1.12.3.40&quot;
}</code></pre>
<ol>
<li><strong>返回参数说明</strong></li>
</ol>
<table>
<thead>
<tr>
<th>参数名</th>
<th>参数类型</th>
<th>参数说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>int</td>
<td>返回状态码，0为成功，2为未完成登录，其它值为失败</td>
<td>0</td>
</tr>
<tr>
<td>msg</td>
<td>string</td>
<td>返回信息，返回错误时的说明</td>
<td>succ</td>
</tr>
<tr>
<td>type</td>
<td>string</td>
<td>登录方式</td>
<td>qq</td>
</tr>
<tr>
<td>social_uid</td>
<td>string</td>
<td>第三方登录UID</td>
<td>AD3F5033279C8187CBCBB29235D5F827</td>
</tr>
<tr>
<td>access_token</td>
<td>string</td>
<td>第三方登录token</td>
<td>89DC9691E274D6B596FFCB8D43368234</td>
</tr>
<tr>
<td>faceimg</td>
<td>string</td>
<td>用户头像</td>
<td><a href="https://thirdqq.qlogo.cn/g">https://thirdqq.qlogo.cn/g</a>?......</td>
</tr>
<tr>
<td>nickname</td>
<td>string</td>
<td>用户昵称</td>
<td>田小檬</td>
</tr>
<tr>
<td>gender</td>
<td>string</td>
<td>用户性别</td>
<td>男</td>
</tr>
<tr>
<td>location</td>
<td>string</td>
<td>用户所在地，仅限支付宝/微信返回</td>
<td>XXXXX市</td>
</tr>
<tr>
<td>ip</td>
<td>string</td>
<td>用户登录IP</td>
<td>1.12.3.40</td>
</tr>
</tbody>
</table>
<h2>四、获取用户信息接口</h2>
<p>在用户登录后的任意时间，可通过此接口再次查询用户详细信息。</p>
<ol>
<li><strong>请求URL</strong>：<code>https://login.lmwa.cn/connect.php?act=query&amp;appid={appid}&amp;appkey={appkey}&amp;type={登录方式}&amp;social_uid={social_uid}</code></li>
<li><strong>请求参数说明</strong>
<ul>
<li><strong>appid</strong>、<strong>appkey</strong>、<strong>type</strong>：同上述接口参数含义。</li>
<li><strong>social_uid</strong>：第三方登录UID，用于唯一识别用户。</li>
</ul></li>
<li><strong>返回格式</strong></li>
</ol>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;succ&quot;,
&quot;type&quot;: &quot;qq&quot;,
&quot;social_uid&quot;: &quot;AD3F5033279C8187CBCBB29235D5F827&quot;,
&quot;access_token&quot;: &quot;89DC9691E274D6B596FFCB8D43368234&quot;,
&quot;nickname&quot;: &quot;大白&quot;,
&quot;faceimg&quot;: &quot;https://thirdqq.qlogo.cn/g?b=oidb&amp;k=ianyRGEnPZlMV2aQvvzg2uA&amp;s=100&amp;t=1599703185&quot;,
&quot;location&quot;: &quot;XXXXX市&quot;,
&quot;gender&quot;: &quot;男&quot;,
&quot;ip&quot;: &quot;1.12.3.40&quot;
}</code></pre>
<ol>
<li><strong>返回参数说明</strong>：与通过Authorization Code获取用户信息接口的返回参数一致。 </li>
</ol>