Latest reading - Enectiva REST API

Latest reading endpoint enables clients to get the latest imported reading for the given meter. It either returns the latest reading (even if marked as suspicious) with 200 or a 404 error when the given meter has no readings stored.

Any token allowed to add readings is able to read the latest reading as well. The purpose is to minimize the number of requests to Librarian. Clients should keep track of readings sent to Librarian on their own. However, if they, for some reason, lose track, the preferred course of action is to use this endpoint rather than to send a series of readings that have been sent earlier. Duplicate requests result in 409 responses.

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/vnd.api+json

Body

Example

{
    "data": {
        "attributes": {
            "customer_uuid": "11e7e767-6f74-4994-b607-158ff7f7445e",
            "import_id": "40AABB_007",
            "sender": "test_script_01",
            "state": 123456.78,
            "suit": "default",
            "suspicious": false,
            "time": "2015-11-18T09:54:23+01:00",
            "unit": "kW"
        },
        "id": 1,
        "type": "readings"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠406Not Acceptable

🟠429Too Many Requests

🔴500Server Error