Create a new access token

POST

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

Last modified:2025-12-22 13:18:41

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, an access token has an scp claim where permissions are stored.

Permissions for an access token are inherited from the import token used to create it

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-12-22 13:18:41

Introduction

List data points of a data series