快手 API

refreshToken

GET/oauth2/refresh_token

refreshToken 使用说明

token 有效期说明：

access_token 有效期：非固定时间，以接口返回时间为主，有变动可能。
refresh_token有效期：非固定时间，以接口返回时间为主，有变动可能。

当access_token失效之前或者之后，都可以使用有效的refresh_token去获取一个新的access_token：

新旧access_token互不干扰，过期时间独立计算，可以同时有效。
接口会同时返回一个refresh_token，同时废弃掉老的refresh_token，但过期时间会继承上一个refresh_token 的过期时间。

特别注意: 当 refresh_token过期之后，当用户再次使用时,需要第三方主动引导用户再次授权。

请求参数

Query 参数

app_secret

string

应用对应的密钥

可选

示例值:

string

refresh_token

string

可选

有效的refresh_token

示例值:

string

grant_type

string

可选

写死 “refresh_token” 即可

示例值:

refresh_token

示例代码

返回响应

Success Response(200)

Error Response:(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

result

integer

必需

错误码。1 表示成功。

access_token

string

授权凭证。

必需

expires_in

integer

必需

access_token 的过期时间，单位为秒。

refresh_token

string

必需

新的有效refresh_token，老的refresh_token随即失效。

refresh_token_expires_in

integer

必需

refresh_token 的过期时间，单位为秒。刷新的时候,过期时间不会延期,会继承上一个refresh_token 的过期时间。

scopes

array[string]

必需

access_token包含的scope,如果返回的scope没有包含开发者需要的scope,说明用户没有点击同意授权,开发者在调用相应的openAPI接口的时候,需要让用户授权。

{
  "result": 1,
  "access_token": "xxxxxxx",
  "expires_in": 3600,
  "refresh_token": "xxxxxx",
  "refresh_token_expires_in": 648000,
  "scopes": [
    "user_info"
  ]
}

最后修改时间： 3 年前