Create Access Token API

Obtain an access token for SePay SoundBox API using Client ID and Client Secret. Required for all requests; the token is valid for 6000 seconds.

||

API Endpoint

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

Authentication

This API uses Basic Authentication with the following credentials:

  • Username: client_id (provided upon registration)
  • Password: client_secret (provided upon registration)
Note
  • Send the request with an empty body (no request body required)
  • Token is valid for 6000 seconds (100 minutes)
  • Use this token in the Authorization: Bearer {access_token} header for subsequent API calls

Error Handling

401Unauthorized

Invalid or missing authentication credentials

Code Examples

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

API Response

Response 201 - Token created successfully
{
  "code": 201,
  "message": "Resource created",
  "data": "—",
  "access_token": "eyJhbGciOi...",
  "ttl": 6000
}
codeinteger

Response status code

messagestring

Execution result description

datastring

Returned data (may be "—" when no data)

access_tokenstring

Access token for other APIs

ttlinteger

Access token time-to-live (seconds)