开发者 OAuth2 关联授权
接入
接入方需要提供 应用名称、可信域名和 clientSecret(如不提供官方将随机生成)
官方会告知你的 clientID 和 clientSecret
整体流程
授权登录目前支持 authorization_code 模式,适用于拥有 server 端的应用授权。
该模式整体流程为:
1. 第三方发起授权登录请求,显示一个授权登录页面,显示对应的图标和应用名称(如果用户没有登录会跳转登录,成功后返回页面)
https://afdian.net/oauth2/authorize?response_type=code&scope=basic&client_id=yourclientid&redirect_uri=urlencodedhttp&state=111
标红部分替换为你自己的数据。为了方便测试,目前回调地址支持 http、https,线上使用请使用 https 保证数据传输安全。state 用来做安全校验。
2. 用户点击同意,重定向到 redirect_uri,会携带 code 和 state。用户拒绝则不会发生重定向
3. 第三方客户端请求服务器,根据 code 换取 access_token,此时会返回 user_id
获取用户ID
注意:为了安全请务必服务端调用该接口,并且走https协议
secret请仅保存到服务端,如有泄露,请第一时间联系官方进行重置。
https://afdian.net/api/oauth2/access_token
form 表单形式POST提交
参数名
数值
备注
grant_type
authorization_code
必填,固定值
client_id
分配的client_id
必填
client_secret
分配的密钥
必填
code
上个流程返回的 code
必填
redirect_uri
注意仍然填写之前的重定向地址,用来核对数据(这里不需要手动encode)
必填
返回 ec em data 结构,仅当 ec 200时表示成功
最后更新于