API Refresh Token
API này được sử dụng để lấy lại ACCESS_TOKEN trong trường hợp ACCESS_TOKEN bị hết hạn. Sau khi gọi lấy refresh token thành công, refresh token cũ sẽ không còn hiệu lực
EndPoint
POST
/api/v1/oauth/refresh_token
Header Params
Tham số | Yêu cầu | Kiểu dữ liệu | Mô tả | Lưu ý |
---|---|---|---|---|
Content-Type | required | String | Giá trị: application/json |
{
"Content-Type": "application/json"
}
Request Params
Tham số | Yêu cầu | Kiểu dữ liệu | Mô tả | Lưu ý |
---|---|---|---|---|
client_key | required | String | API KEY AppotaPay cung cấp | |
secret_key | required | String | SECRET KEY AppotaPay cung cấp | |
grant_type | required | String | Mặc định: authorization_code | |
refresh_token | required | String | Refresh token trả về ở API Lấy Access Token Tài Khoản Ví |
Example Request
{
"client_key": "1VXlZjO7vY7BJokQyaGbA5b3C9eT040pEdQq",
"secret_key": "R3cIrn81uYHgNLPOeqrFoCtG8UzJ",
"grant_type": "authorization_code",
"refresh_token": "R3cIrn81uYHgNLPOeqrFoCtG8UzJ1VXlZjO7vY7"
}
Response Params
{
"code": 200,
"data": {
"access_token": "c3ec19b7a8d93a7ee7be88aa2f2be328",
"token_type": "Bearer",
"refresh_token": "c09eb4ed6c65d152de9fcd74fdfe9cce",
"expiry_in": 1659411793,
"refresh_token_expiry_in": 1659411793
}
}
Thành công
Http Status Code
200
-OK
Tham số | Kiểu dữ liệu | Mô tả | Lưu ý |
---|---|---|---|
code | Integer | Mã lỗi | |
data | Object | Chi tiết dữ liệu | |
data.access_token | String | Access Token của hệ thống Appota. | |
data.token_type | String | Loại token | Mặc định: Bearer |
data.refresh_token | String | Refresh Token của hệ thống Appota. | |
data.expiry_in | Integer | Thời hạn của access token | Unix timestamp |
data.refresh_token_expiry_in | Integer | Thời hạn của refresh token | Unix timestamp |
Thất bại
HTTP Status Code !=
200
Tham số | Kiểu dữ liệu | Mô tả | Lưu ý |
---|---|---|---|
code | Integer | Mã lỗi | |
message | String | Mô tả thêm về lỗi |