Skip to content

Device Token Renewal

A device’s access token will expire after 7 days. To ensure the device always has a valid token, it should periodically send a request to the /loginDevice endpoint.

Login Device Endpoint

Request

POST /loginDevice

The endpoint expects the following fields in JSON format:

  • token - the device’s current access token (even if it is expired)
  • cpu_id - the device’s CPU ID
  • uuid - the device’s UUID

Response

  • If one of the fields was missing or given an incorrect value, the endpoint will return a 400 response.
  • If the token is valid, the endpoint will return a 200 response.
  • If the token is valid but expires within 12 hours, the endpoint will return a 201 response with a token field in the body.
    • The device should use the new token for all future requests.
  • If the token is expired, the endpoint will return a 201 response with a token field in the body.
    • The device should use the new token for all future requests.