🔐Access Tokens

Tokens are provided upon registration, additional endpoints are prvided to re-allocate the access token where a new token will be issued, revoking the old token. A time period of validity is provided where both tokens will be active when requesting a new token.

Reallocate Token

post

Header parameters

AuthorizationstringRequired

Secret Token for user authentication

Example: {"value":"Token tk-abcdef-uhhgggggf-yygfff"}

Body

application/json

valid_uptointeger · max: 30RequiredExample: 15

Responses

200

token reallocated successfully

application/json

messagestringOptionalExample: token reallocated successfully, old token is valid upto YYYY-MM-DD HH:MM:SS.mm+02:00

tokenstringOptionalExample: tk-uvwxyz-abcdefghi-jklmno

400

Bad request - token reallocation failed

application/json

500

Internal server error

application/json

post

/api/v1/reallocate-token

HTTPcURLJavaScriptPython

POST /api/v1/reallocate-token HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "valid_upto": 15
}

{
  "message": "token reallocated successfully, old token is valid upto YYYY-MM-DD HH:MM:SS.mm+02:00",
  "token": "tk-uvwxyz-abcdefghi-jklmno"
}