API v1.0 [EM50G ONLY!]

Updated by Travis Bates

We recommend all clients migrate to API version 3.0.

How to access the API documentation:
  1. Login at zentracloud.com
  2. Navigate to https://zentracloud.com/api/v1/guide
  3. Here you can try out the readings, status, and setting endpoints. Find the endpoints that generate and use tokens and use them as a guide.
Examples:
  1. Download Postman from https://www.getpostman.com. This is an awesome free tool for testing API calls.
  2. Open Postman and import the postman collection. This will show you exact API calls and how they should be setup.
  3. Click through the token API request and you can generate a token that is used for other API requests. Notice the headers and body. This you'll need to duplicate in your code.
  4. Check out the other API requests and again, notice the headers. You'll need a Content-Type header as well as an Authorization header.
v1 Endpoints:

Make sure you are using the v1 API. Here are a few of the endpoints you'll be using:

API guidelines:
  1. Use the start_mrid or start_time whenever possible. This allows you to get a faster response from the API and only get the data you haven't yet received.
  2. Do not query the API more frequently than logger is sending data to the server. While the logger can be making measurements at intervals less than an hour, most loggers only send data to the server hourly or less frequently. It doesn't make sense to query more frequently because no new data will be available.
Users that abuse the server may be disallowed access.

How did we do?

Powered by HelpDocs (opens in a new tab)