总览

OAuth 2.0 授权码流程,获取token

第一步:用户同意授权,获取code

//app-auth.kingxunlian.com?client_id=xxxx&response_type=xxxxx&scope=xxxxxx&state=xxxxx&redirect_uri=xxxxx

  • 参数说明
参数名 是否必填 备注
client_id 必填 appKey
response_type 必填 当前只允许传入 ‘code’,即授权码模式
scope 非必填 申请的权限范围(oauth2保留字段)
state 非必填 客户端当前状态 (oauth2保留字段)
redirect_uri 必填 跳转回调,且地址必须属于应用主域

授权成功页面将跳转至 redirect_uri/?code=CODE&state=STATE

  • 参数名说明
参数名 备注
code 作为换取access_token的票据,每次用户授权带上的code将不一样,code只能使用一次,10秒未被使用自动过期
state 客户端当前状态,返回请求传入的state

第二步:通过code换取网页授权access_token

获取code后,请求以下链接获取access_token:

POST /open-platform/auth/oauth2/access-token

  • 参数名说明
参数名 是否必填 备注
grant_type 必填 当前只允许传入 ‘authorization_code’
code 必填 第一步返回的code
client_id 必填 appKey
client_secret 必填 appSecret,应用密钥

三、OAuth 2.0 通过接口操作用户资源

接下来将以一个例子,说明如何通过OAuth 2.0 3-Legged方式访问API

访问例子接口:GET https://api.dev.kingxunlian.com/plat/company/current-user/get


第一步:组装生成Header

Key Value 备注
Authorization “Bearer “ + access_token 注意空格

第二步:发送请求,并得到结果

文档更新时间: 2019-07-12 17:05   作者:admin