US Server API

Updated by Travis Bates

This article details where and how to use the documentation for the US server API.

Documentation (US server)

https://zentracloud.com/api/v4/documentation/

v4 of the ZENTRA Cloud API is now available for production. METER recommends new clients start with v4. Existing clients can switch to using v4 if they encounter issues with pagination in v3. Both v3 and v4 support queries for ATMOS 41W, ZL6, EM60G and EM50G devices. The documentation for v3 and v4 is the same, users can simply change the version number in the endpoint URL from "v3" to "v4".

Call limits

Users are limited to a total of 60 calls per minute(60sec), and each device is limited to 1 call per minute(60sec). One user can make 60 calls to 60 different devices in a 60 second period.

Token

  • Select API.
  • Click Copy token.

Test

Authorize
  • Select Authorize.
  • Paste token ID.
  • Click Authorize.

GET request

To view examples press the GET readings button.

Parameters

Experiment with different start_date, end_date, or start_mrid and end_mrid query parameters. Only start_date and end_date or start_mrid and end_mrid parameters need to be defined in the request, not both. MRID stands for "Measurement Record ID" and increases as the number of records on the device increases.

Response format

Select the output_format. Options include json, pandas dataframe or csv.

Examples

View examples in json, csv or pandas Dataframe.

Units

To set the units, login to your account at zentracloud.com and click the wrench icon from the main menu and select Measurement Units. Edit your preferred units and click Accept. See Setting your preferred measurement units article here.

How did we do?

Powered by HelpDocs (opens in a new tab)