refreshToken

2023-09-22 03:10

POST /amsin/api/v1/oauth/applyToken

需要签名验签

访问令牌（access token）会在授予后30天过期。集成商调用此接口来刷新或者延长访问令牌（access token）。

接口结构

万里汇接口的报文结构包括：请求头、请求体、响应头和响应体。该章节主要介绍请求体和响应体的结构。关于请求头和响应头的更多信息，参见：

请求体参数

字段名

数据类型

是否必传

描述

refreshToken

字符串

是

刷新令牌（refresh token) ，由 applyToken API返回。

grantType

字符串

是

授权模式。可取值：

REFRESH_TOKEN : 使用刷新令牌（refresh token) 来获得访问令牌（access token）。

响应体参数

字段名	数据类型	是否必传	描述
result	Result 对象	是	API的调用结果。
说明：以下字段，只有当 result.resultStatus = `S` 时才会按需返回。
accessToken	字符串	是	访问令牌（access token）
expireTime	DateTime 字符串	是	访问令牌（access token）的过期时间更多信息：此字段采用ISO 8601 标准时间戳。如：`2018-09-03T00:00:00+08:00`，或`2019-01-01T01:01:01Z`（UTC时间）
refreshToken	字符串	否	刷新令牌（refresh token)
refreshTokenExpireTime	DateTime 字符串	否	刷新令牌（refresh token) 的过期时间更多信息：此字段采用ISO 8601 标准时间戳。如：`2018-09-03T00:00:00+08:00`，或`2019-01-01T01:01:01Z`（UTC时间）
extendInfo	字符串	否	拓展字段

结果码

result.resultCode

resultCode	resultStatus	resultMessage	resultMessage 中文含义	处理建议
SUCCESS	S	Success	成功
PROCESS_FAIL	F	A general business failure occurred. Do Not retry.	请求处理失败，请勿重试	需要人工介入，联系万里汇技术支持以解决此问题
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	参数异常	修改订单信息、更换requestId，发起重试
INVALID_API	F	The called API is invalid or not active.	调用的接口已失效或停用	确认是否调用正确的API
INVALID_CLIENT	F	The client is invalid.	调用的用户无效	Client ID不存在或无效
INVALID_SIGNATURE	F	The signature is invalid.	签名校验失败	确认请求正确加签，更换requestId，发起重试
METHOD_NOT_SUPPORTED	F	The server does not implement the requested HTTP method.	HTTP请求方法不支持。	确认HTTP请求方法为`POST`
UNKNOWN_EXCEPTION	U	The API call is failed, which is caused by unknown reasons.	未知错误	无需更换requestId，发起重试
UN_SUPPORT_BUSINESS	F	Unsupported business.	包含无效参数	包含无效参数，使用正确参数重试
AUTHORIZATION_NOT_EXIST	F	The authorization does not exist.	授权不存在	当前token授权关系不存在，请联系万里汇技术支持检查token授权关系

代码示例

请求成功

请求体

copy
{
    "refreshToken": "282888130000470616850250350*****",
    "grantType":"REFRESH_TOKEN"
}

响应体

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "success"
    },
  "accessToken":"282888030000856***85343115000MUg***lrfM171000449",
  "refreshToken":"28288***0000856***85343***000MUg***lrfM171000449",
  "expireTime": "2023-05-29T06:27:25Z",
  "refreshTokenExpireTime": "2122-05-29T06:27:25Z"
}

请求失败

请求体

copy
{
    "refreshToken": "282888130000470616850250350*****",
    "grantType":"REFRESH_TOKEN"
}

响应体

copy
{
    "result": {
        "resultCode": "AUTHORIZATION_NOT_EXIST",
        "resultMessage": "The authorization does not exist",
        "resultStatus": "F"
    },
}