Create a new access token

POST

https://api.enectiva.cz//access_tokens

Last modified:2025-10-31 18:47:17

This action lets you use a long‑lived login token to obtain a short‑lived access token, which you can then use to access other resources. The access token is a JWT that you can inspect to verify its permissions and validity.

For access tokens, the validity is limited to 5 minutes.

In addition to standard claims, each token includes an exp claim that contains a NumericDate (a Unix timestamp in whole seconds, UTC, since 1970‑01‑01T00:00:00Z). The token is rejected once the current time is at or past exp. When it expires, you must acquire a new access token.

At the same time, the permissions are stored in the scp claim.

Request

Header Params

Body Params application/vnd.api+json

Example

{
    "data": {
        "attributes": {
            "customer_uuid": "9796513c-e811-4b75-b2eb-b36b9f1a1b8c",
            "login_token": "5d16cbf4794439be3139a2009edc8cc06911802102214b5fce8320ff4edb61ae"
        },
        "type": "login_tokens"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.enectiva.cz//access_tokens' \
--header 'Accept: application/vnd.api+json' \
--header 'Content-Type: application/vnd.api+json' \
--data-raw '{
    "data": {
        "attributes": {
            "customer_uuid": "9796513c-e811-4b75-b2eb-b36b9f1a1b8c",
            "login_token": "5d16cbf4794439be3139a2009edc8cc06911802102214b5fce8320ff4edb61ae"
        },
        "type": "login_tokens"
    }
}'

Responses

🟢201Created

application/vnd.api+json

Created

Body

Example

{
    "data": {
        "attributes": {
            "encoded": "eyJhbGciOiJFUzI1NiJ9.eyJzY3AiOlsiZW50aXR5X2NvbnN1bXB0aW9ucyJdLCJqaXQiOiJjMGY2ODdhYzZiNDdjM2FiIiwibHRpIjo4LCJzdWIiOiI1MTIzZDhlZi1iNTAxLTRjNzEtYjE4OC04M2FjMzk5ZDY2YjkiLCJleHAiOjE1NzQ3NzU5NjgsImtleSI6MX0.jbRqzsRS78yEuLO5advtgjlYgEbL4UckDoErj2Wc2SjM-pjr1MGUvb2uZkCcIxAmkLfy99pjNW8OT2t9snL6xw"
        },
        "id": "c0f687ac6b47c3ab",
        "type": "access_tokens"
    }
}

🟠400Bad Request

🟠406Not Acceptable

🟠415Unsupported Media Type

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-10-31 18:47:17

Introduction

List data points of a data series