刷新访问 Token

访问 token 的有效时长为 30 分钟。为保证 PBX 和 第三方应用之间的通信,你需要使用此接口来刷新访问 token。

请求 URL

POST {base_url}/{api_path}/refresh_token

请求参数

参数 是否必填 类型 说明
refresh_token String 当前最新的刷新 token。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0:请求成功。
  • 非零值:请求失败。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息
errmsg String 返回信息。
  • SUCCESS:请求成功。
  • FAILURE:请求失败。
access_token_expire_time Integer 访问 token 有效时长。

单位:秒(s)

access_token String 新的访问 token。
refresh_token_expire_time Integer 刷新 token 有效时长。

单位:秒(s)

refresh_token String 新的刷新 token。

示例

请求示例

POST /openapi/v1.0/refresh_token

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json

{
	"refresh_token": "SCduGecwbG9jIusiS8FxFUVn3kf0Q9R8"
}

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "access_token_expire_time": 1800,
    "access_token": "4JkX5GQObeL9MGcPZDN4o4Ecv114Jo1e",
    "refresh_token_expire_time": 86400,
    "refresh_token": "fTyEpc1OTDU2vckJauWL6uBRasYYpbKU"
}