Create a new data point - Enectiva REST API

This endpoint enables clients to add new data points in custom data series to Enectiva. Each data point is sent in a separate HTTP request. There's no recommended frequency of data points sent because it depends on the time series, but too frequent requests might lead to rate limiting (429).

The data points should be sent in chronological order. Data points with time before the latest data point in any given series will be accepted, but might not be used by Enectiva.

Each data point must satisfy validation rules:

time, value and import_id are required

time must conform to format defined in RFC3339, the time will be truncated to whole seconds

value has to be a floating point number; we recommend sending only reasonable number of digits after the decimal point

import_id is limited to 255 characters, it is case-sensitive, must not contain spaces

sender is a case-sensitive string limited to 255 characters used for debugging and verification

suit is an optional string identifying the series of readings, if not provided default will be used, must not contain spaces

data point must be in the past

For testing integration of a new client, we recommend using dummy series IDs (e.g. test).

An attempt to insert an identical data point (the same import_id, suit, time and value) will result in 409 status code.

This endpoint requires an import token, not an access token.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://app.enectiva.cz/en/api/dashboard

Token URL: No token URL is provided. Use "Import token" from the Auth URL

Path Params

Header Params

Body Params application/vnd.api+json

Example

{
  "data": {
    "type": "data_points",
    "attributes": {
      "time": "2016-01-07T05:23:41+01:00",
      "value": 550011.34,
      "import_id": "temp_01",
      "sender": "test_script_01",
      "suit": "default"
    }
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created

application/vnd.api+json

Created

Body

Example

{
    "data": {
        "attributes": {
            "customer_uuid": "11e7e767-6f74-4994-b607-158ff7f7445e",
            "import_id": "temp_01",
            "sender": "test_script_01",
            "suit": "default",
            "time": "2016-01-07T05:23:41+01:00",
            "value": 550011.34
        },
        "id": 1,
        "type": "data_points"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠406Not Acceptable

🟠409Conflict

🟠415Unsupported Media Type

🟠429Too Many Requests

🔴500Server Error