API tạo access token

Lấy access token cho SePay SoundBox API bằng Client ID và Client Secret. Bắt buộc cho mọi request, token có hiệu lực 6000 giây sau khi tạo.

||

API Endpoint

POST
https://speaker-api.sepay.vn/devices/v1/token/create

Xác thực

API này sử dụng Basic Authentication với thông tin đăng nhập:

  • Username: client_id (được cấp khi đăng ký)
  • Password: client_secret (được cấp khi đăng ký)
Lưu ý
  • Gửi yêu cầu với body rỗng (không cần request body)
  • Token có hiệu lực 6000 giây (100 phút)
  • Sử dụng token này cho header Authorization: Bearer {access_token} trong các API tiếp theo

Xử lý lỗi

401Unauthorized

Thông tin xác thực không hợp lệ hoặc bị thiếu

Code mẫu

>
>
>
curl --request POST \
--url https://speaker-api.sepay.vn/devices/v1/token/create \
--header 'Authorization: Basic REPLACE_BASIC_AUTH'

API Response

Response 201 - Tạo token thành công
{
  "code": 201,
  "message": "Resource created",
  "data": "—",
  "access_token": "eyJhbGciOi...",
  "ttl": 6000
}
codeinteger

Mã trạng thái phản hồi

messagestring

Mô tả kết quả thực thi

datastring

Dữ liệu trả về (có thể là "—" khi không có data)

access_tokenstring

Mã truy cập dùng cho các API khác

ttlinteger

Thời gian sống của access token (giây)