Refresh

🇬🇧 English

Note: Username and password are generated in the BizMail Portal. Please log in to your account at the portal to obtain your credentials before calling these APIs.

Refresh Token

POST /api/1.0/auth/refresh

Use the refresh_token to get a new pair of access token and refresh token without re-entering credentials.

Headers

Body (JSON)

Example Request

{
  "refresh_token": "<jwt_refresh_token>"
}

Responses

200 OK — Success

{
  "success": true,
  "access_token": "<new_jwt_access_token>",
  "refresh_token": "<new_jwt_refresh_token>",
  "token_type": "Bearer",
  "expires_in": 86400
}

400 Bad Request — Missing field

{
  "success": false,
  "message": "refresh_token is required"
}

401 Unauthorized — Token expired

{
  "success": false,
  "message": "Refresh token expired"
}

401 Unauthorized — Invalid token

{
  "success": false,
  "message": "Invalid refresh token"
}

401 Unauthorized — User not found

{
  "success": false,
  "message": "User not found"
}

500 Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Usage

Use the new access_token in subsequent requests via the Authorization header:

Authorization: Bearer <access_token>

When the refresh_token also expires (after 90 days), call POST /api/1.0/auth/token again to get a new pair.

🇻🇳 Tiếng Việt

Lưu ý: Username và password được tạo trên BizMail Portal. Vui lòng đăng nhập vào tài khoản của bạn trên portal để lấy thông tin đăng nhập trước khi gọi các API này.

Refresh Token

POST /api/1.0/auth/refresh

Dùng refresh_token để lấy cặp token mới mà không cần nhập lại username/password.

Headers

Body (JSON)

Ví dụ Request

{
  "refresh_token": "<jwt_refresh_token>"
}

Responses

200 OK — Thành công

{
  "success": true,
  "access_token": "<new_jwt_access_token>",
  "refresh_token": "<new_jwt_refresh_token>",
  "token_type": "Bearer",
  "expires_in": 86400
}

400 Bad Request — Thiếu tham số

{
  "success": false,
  "message": "refresh_token is required"
}

401 Unauthorized — Token hết hạn

{
  "success": false,
  "message": "Refresh token expired"
}

401 Unauthorized — Token không hợp lệ

{
  "success": false,
  "message": "Invalid refresh token"
}

401 Unauthorized — Không tìm thấy user

{
  "success": false,
  "message": "User not found"
}

500 Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Cách sử dụng

Dùng access_token mới trong header Authorization của các request tiếp theo:

Authorization: Bearer <access_token>

Khi refresh_token cũng hết hạn (sau 90 ngày), gọi lại POST /api/1.0/auth/token để lấy cặp token mới.