获取用户信息说明
<h2>一、接口概述</h2>
<p>获取用户信息接口用于在用户完成第三方平台登录授权后，帮助开发者获取用户在第三方平台的相关信息，如昵称、头像、性别、所在地等。这些信息有助于开发者在自有应用中完善用户资料，提供个性化服务，增强用户体验。该接口不仅适用于用户首次登录后创建用户档案，也可用于后续更新用户信息，确保应用内用户数据与第三方平台保持同步。</p>
<h2>二、接口基本信息</h2>
<ol>
<li><strong>请求地址</strong>：<code>https://login.lmwa.cn/connect.php?act=query</code></li>
<li><strong>请求方式</strong>：GET 请求。在实际应用中，由于该接口主要用于获取数据，GET 请求符合其操作特性，且方便将参数拼接在 URL 中进行传递，直观简洁，易于理解和调试。</li>
</ol>
<h2>三、请求参数说明</h2>
<table>
<thead>
<tr>
<th>字段名</th>
<th>是否必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>appid</td>
<td>是</td>
<td>String</td>
<td>123456abcdef</td>
<td>开发者在聚合登录平台申请的应用 ID，用于标识开发者的应用，平台通过该 ID 验证应用的合法性和权限。</td>
</tr>
<tr>
<td>appkey</td>
<td>是</td>
<td>String</td>
<td>abcdef1234567890</td>
<td>与 appid 对应的应用密钥，用于对请求进行签名验证，确保请求来源可靠且未被篡改。开发者需妥善保管该密钥，避免泄露。</td>
</tr>
<tr>
<td>type</td>
<td>是</td>
<td>String</td>
<td>qq</td>
<td>指定用户登录所使用的第三方平台类型。取值范围对应不同的第三方平台，如<code>qq</code>代表 QQ 登录、<code>wx</code>代表微信登录、<code>baidu</code>代表百度登录等。通过该参数，接口能够准确从相应平台获取用户信息。</td>
</tr>
<tr>
<td>social_uid</td>
<td>是</td>
<td>String</td>
<td>AD3F5033279C8187CBCBB29235D5F827</td>
<td>用户在第三方平台的唯一标识。在用户完成第三方平台登录授权后，通过登录成功回调获取该标识。此标识在第三方平台内具有唯一性，用于精准定位用户信息。</td>
</tr>
</tbody>
</table>
<h2>四、返回参数说明</h2>
<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>succ</td>
<td>返回信息。当请求成功时，显示成功提示信息；请求失败时，详细说明失败原因，方便开发者调试和处理。</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>qq</td>
<td>用户登录所使用的第三方平台类型，与请求参数中的 type 值一致，用于确认信息来源平台。</td>
</tr>
<tr>
<td>social_uid</td>
<td>String</td>
<td>AD3F5033279C8187CBCBB29235D5F827</td>
<td>用户在第三方平台的唯一标识，再次确认用户身份，确保信息对应准确。</td>
</tr>
<tr>
<td>access_token</td>
<td>String</td>
<td>89DC9691E274D6B596FFCB8D43368234</td>
<td>第三方平台颁发的访问令牌。通过该令牌，开发者的应用可以在一定权限范围内访问第三方平台的用户资源，如获取更多详细信息等。令牌具有时效性，需注意有效期管理。</td>
</tr>
<tr>
<td>nickname</td>
<td>String</td>
<td>大白</td>
<td>用户在第三方平台设置的昵称，可用于在开发者应用中显示用户名称，增强用户的个性化标识。</td>
</tr>
<tr>
<td>faceimg</td>
<td>String</td>
<td><a href="https://thirdqq.qlogo.cn/g?b=oidb&amp;k=ianyRGEnPZlMV2aQvvzg2uA&amp;s=100&amp;t=1599703185"><a href="https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185">https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185</a></a></td>
<td>用户头像图片的 URL 地址。开发者可根据该地址在应用内展示用户头像，提升用户界面的直观性和用户体验。</td>
</tr>
<tr>
<td>location</td>
<td>String</td>
<td>XXXXX 市</td>
<td>用户所在地信息（部分平台返回）。有助于开发者根据用户地理位置提供本地化服务或内容推荐等。</td>
</tr>
<tr>
<td>gender</td>
<td>String</td>
<td>男</td>
<td>用户性别信息。可用于应用内的个性化推荐、社交互动等场景，根据用户性别提供更贴合需求的服务。</td>
</tr>
<tr>
<td>ip</td>
<td>String</td>
<td>1.12.3.40</td>
<td>用户登录时的 IP 地址。可用于安全监测、分析用户登录位置分布等。</td>
</tr>
</tbody>
</table>
<h2>五、接口使用注意事项</h2>
<ol>
<li><strong>签名验证</strong>：在发起请求时，开发者务必按照聚合登录平台规定的签名规则，使用<code>appkey</code>对请求参数进行签名，并将签名结果作为请求参数一同发送。平台会对请求进行签名验证，若签名不通过，将返回错误信息，拒绝提供用户信息。</li>
<li><strong>参数准确性</strong>：确保请求参数<code>appid</code>、<code>appkey</code>、<code>type</code>、<code>social_uid</code>的准确性。错误的参数可能导致无法正确获取用户信息，甚至引发安全问题。尤其是<code>appkey</code>和<code>social_uid</code>，需严格保密，防止泄露。</li>
<li><strong>错误处理</strong>：当接口返回状态码不为 0 时，开发者应根据返回的<code>msg</code>信息，妥善处理错误情况。例如，若因参数错误导致请求失败，需检查并修正参数后重新发起请求；若因授权过期，需引导用户重新进行授权操作。</li>
<li><strong>数据更新</strong>：由于用户信息可能在第三方平台发生变化，开发者可根据业务需求，定期调用该接口获取最新的用户信息，保持应用内用户数据的实时性和准确性。</li>
</ol>