NeQ5v7T72vm4Yi6ADyYAW6m4eVK
客户端ID（第一步申请得到的）。
SiGEWINNEQWQ
随机字符串，防止CSRF，请求方应当生成并记录此字符串，用于后续验证。
非必须，但强烈建议。https://api.mslmc.cn/api/callback
登录成功后重新向的地址（一般是编码的地址），若不传此参数则读取App设置的URI地址。
非必须，但强烈建议。MSL OAuth 2.0
TIPS
此处介绍的开发者将自己的服务 接入MSL统一身份验证（即MSL用户中心服务） 第三方登录 。
若您并不知道什么意思，那就别看啦~
1.申请OAuth App
进入MSL用户中心的OAuth App管理页面，点击添加应用。
填写应用的 名字，图标（推荐正方形，需要是可以外部访问的url地址），以及您的App的 回调地址 。
注意：应用权限请保持默认的选择 用户信息 。
关于应用权限
如果你只是需要调用MSL用户中心进行登录，那么选择 用户信息 是完全足够的。
所有权限 是提供MSL账号的完全访问权限，仅适用于对接我们的其他服务（如MSLFrp），若您有这方面的需求，可以在Q群或者邮件联系我们商讨后为您开通相关权限并提供此授权模式的两种方法的文档（App/网页）。support@mslmc.cn
点击确定后，会返回您的App 客户端ID 以及 密钥 信息。
注意
请妥善保管您的密钥，密钥仅会显示一次 。 后续若忘记密钥就只能重置了。
审核
添加App后会进入待审核状态，请 联系管理员审核 。 否则App无法正常调用哦！
2.OAuth流程
请求获取授权码（跳转MSL用户中心授权）
请求跳转授权地址：
https://user.mslmc.net/oauth/authorize查询参数:
示例拼接地址:
https://user.mslmc.net/oauth/authorize?client_id=NeQ5v7T72vm4Yi6ADyYAW6m4eVK&state=SiGEWINNEQWQ&redirect_uri=https%3a%2f%2fapi.mslmc.cn%2fapi%2fcallback最小示例拼接地址
https://user.mslmc.net/oauth/authorize?client_id=NeQ5v7T72vm4Yi6ADyYAW6m4eVK但是不建议这么做，缺少 state 参数可能会导致一些风险（如：跨站攻击）哦~
若地址正确，访问后应该是如下页面:
使用授权码交换AccessToken
登录成功后，MSL用户中心将根据填写的App回调地址重定向并添加 code 和 state 参数（方法是GET）
提示
code 有效期只有 10分钟 。
MSL用户中心授权成功的重定向示例:
https://api.mslmc.cn/api/callback?code=y94vzbhskzcizEDmJMbWt775tbI&state=iGEWINNEQWQ您的客户端接收到回调后应该核对 state 否与请求时的一致，若不一致，请 拒绝登录请求 。
然后需要用拿到的code通过api交换得到AccessToken
POST application/x-www-form-urlencoded 或者 application/jsonhttps://user.mslmc.net/api/oauth/exchangeAccessTokeny94vzbhskzcizEDmJMbWt775tbI回调拿到的授权码
NeQ5v7T72vm4Yi6ADyYAW6m4eVK您在第一步申请的客户端ID
FAOFoGDPtTK8Yudlerv...您在第一步申请的客户端密钥
返回示例:
{ "code": 200, "msg": "授权成功", "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjEsImlhdCI6MTc0NzU1NzY3MiwiZXhwIjoxNzQ3NTYxMjcyfQ.iyX0dIXxrUkr6Dg7HCZ7YNQb2G1u5EYpzh-6wKYJShg", "expires_in": 3600, "token_type": "Bearer", "scope": "user_info" }获取到 access_token 即可
获取用户信息
GET接口适用提醒
本api接口仅适用于权限类型为 用户信息 的应用。
若您使用的应用类型为所有权限，请参照我们提供的API文档获取用户信息。
https://user.mslmc.net/api/oauth/user需要添加 Authorization 请求头
在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token 示例:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjEsImlhdCI6MTc0NzU1NzY3MiwiZXhwIjoxNzQ3NTYxMjcyfQ.iyX0dIXxrUkr6Dg7HCZ7YNQb2G1u5EYpzh-6wKYJShg返回示例:
{ "code": 200, "msg": "获取用户信息成功", "uid": 1, "username": "小可爱", "email": "user@mslmc.cn", "qq": null, "score": 1500, "avatar": "https://cravatar.cn/avatar/d31946d60f6051840edc9d41a1261?d=identicon&s=640", "regTime": 1737992780, "lastLoginTime": 1745988703, "permission": 1, "realName": false, "lastCheckInTime": null, "twoFactorAuth": true }请使用 uid 字段作为判断用户绑定的参数，这是每位用户唯一的ID，且不会变化。
其他的信息按需使用/更新即可。
3.快速接入MSL登录
# 接入到WordPress
使用此插件:
下载zip，并在您的wordpress上安装并启用插件。
在插件设置填写OAuth App信息:
回调地址要填写到OAuth App信息中
两边的信息配置好后，即可进入个人资料页面绑定MSL账户，绑定后即可使用MSL账户快速登录~
