允许隐式授权
response_type=token 的方式,令牌直接通过 hash 返回给客户端,详细说明可百度强制状态验证
state 参数必须存在精确的重定向 URI
传参时的重定向 URI 必须和创建应用时填写的一致令牌有效期
令牌的有效期,单位为秒
应用名称
应用的名称应用描述
应用的描述应用图标
应用的图标,可选应用主页
应用的主页,可选应用回调地址
应用的回调地址,必填,多个地址使用空格分隔(不推荐单个应用使用多个地址)权限
可选(不清楚的话不要填)授权类型
可选(不清楚的话不要填)应用 ID
和应用密钥
用于客户端认证,添加应用时自动生成,不要泄露给其他人
大部分人只需要 user.read
权限即可,如果你需要更多的权限,可以在这里添加(或许你需要先了解一下 OAuth 中的 scope)
权限标识
权限唯一标识符,用于区分,可参考Github
的权限标识资源路径
需要鉴权的资源路径请求方法
资源路径鉴权的请求方法,一般为GET
默认
勾选此项后哪怕传参时 scope 参数中无此权限标识,也会默认添加此权限名称
权限的名称,用于显示描述
权限的描述,用于显示,可使用{user}
{client_name}
变量指代用户和客户端名称图标
支持FontAwesome
图标和普通图片
/oauth/authorize
参数 | 说明 | 必填 | 默认值 | 示例 |
---|---|---|---|---|
client_id | 应用 ID | 是 | 无 | 123456 |
response_type | 授权类型 | 是 | 无 | code 或 token |
redirect_uri | 重定向 URI | 是 | 应用回调地址 | https://example.com/oauth/callback |
scope | 权限 | 否 | 无 | user.read |
state | 状态 | 否 | 无 | 123456 |
示例:
GET https://example.com/oauth/authorize?client_id=123456&response_type=code&redirect_uri=https://user.example.com/oauth/callback&scope=user.read&state=123456
/oauth/token
参数 | 说明 | 必填 | 默认值 | 示例 |
---|---|---|---|---|
client_id | 应用 ID | 是 | 无 | 123456 |
client_secret | 应用密钥 | 是 | 无 | 123456 |
grant_type | 授权类型 | 是 | 无 | authorization_code 或 refresh_token |
code | 授权码 | 授权类型为 authorization_code 时必填 | 无 | 123456 |
refresh_token | 刷新令牌 | 授权类型为 refresh_token 时必填 | 无 | 123456 |
redirect_uri | 重定向 URI | 授权类型为 authorization_code 时必填 | 应用回调地址 | https://example.com/oauth/callback |
示例:
POST https://example.com/oauth/token
Payload: client_id=123456&client_secret=123456&grant_type=authorization_code&code=123456&redirect_uri=https://example.com/oauth/callback
/api/user
参数 | 说明 | 必填 | 默认值 | 示例 |
---|---|---|---|---|
access_token | 访问令牌 | 是 | 无 | 123456 |
示例:
GET https://example.com/api/user?access_token=123456