top
关闭

开发者登录

oauth认证类接口

主要使用场景:oauth认证类接口

1、获取Oauth令牌

基础 需要授权

第三方从oauth授权登录后跳转的链接中获取到用户的personId和oauthCode,通过oauthCode临时码获取Oauth令牌(默认15天有效,使用后会延长),然后保存到系统中,这样两个平台间用户的关系就绑定了。

前置条件

获取接口访问凭证:accessToken

请求说明

urlhttps://gateway.tianyuyun.com/oauth/getOauthToken?accessToken={{accessToken}}
请求方式post
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

序号 字段名 约束 类型 长度 说明

1

oauthCode

必选

String

oauth授权登录后返回的凭证

返回说明

序号 字段名 约束 类型 长度 说明

1

retCode

必选

String

结果编码

2

retDesc

必选

String

结果描述

3

data

必选

json

json对象

4

expiry

必选

String

时间戳

5

oauthToken

必选

String

Oauth令牌

示例

请求参数:
{
  "oauthCode": "0b37d86ec2796085eb4******"
}

返回示例
{
   "retCode": "000000",
   "retDesc": "success",
   "data":    {
      "expiry": 1602052142464,
      "oauthToken": "bec21f569fb7e183205f94497ecbe9c5"
   }
}