刷新用户凭证

POST

/user/token/refresh

当用户access_token过期后，需要使用refresh_token来换取最新的access_token
请求接口时不需要在请求头中设置Authorization参数，只需在请求体中携带refresh_token即可

注意

refresh_token有效期默认为24天
请求刷新接口后，会签发新的access_token和新的refresh_token，旧的会被销毁

请求参数

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/user/token/refresh' \
--form 'appid="{{appid}}";type=false' \
--form 'appsecret="{{appsecret}}";type=false' \
--form 'refresh_token="{{refresh_token}}"'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "atk_auth_8bb432b0b84c8efxxxc180450cd2e2a4414",
        "access_token_expires_in": 43200,
        "access_token_expires_at": "2026-02-12 11:12:53",
        "refresh_token": "rtk_auth_9b3ad87968e005xxx1bcbd7ad706de547e9cf1a",
        "refresh_token_expires_in": 2073600,
        "refresh_token_expires_at": "2026-03-07 23:12:53"
    }
}

修改于 2026-02-11 15:17:19

获取用户数据

获取第三方平台账号