Overview

Wiser Energy Monitoring Cloud API allows partner to view the metadata information of the Devices in a site or location.

API overview and usage

This API enables the following features:

Location Information

  • Overview of Location: Easily find out which locations are available for your customer portfolio.

Sites, Rooms and Devices Information

  • Overview of Sites, Rooms & Devices: Review all the metering devices connected to any given site in your portfolio.

Documentation

How to sign up

Step 1: Register or login with an Exchange account.

Step 2: Subscribe to the API product in our Shop.

Step 3: After subscription, API credentials and usage details for the API are available in developer portal.

Authentication guide

This API supports the following authentication mechanism:

OAuth2 Authorization Code Flow

This authorization schema is intended for ISV applications that have obtained authorization from a Schneider Electric customer. Follow the steps below to initiate the authorization process, obtain an access token, and refresh the token as needed. Step 1: Initiate Authorization and Consent Flow Firstly, your application should initiate the Authorization and Consent flow by calling the Authorize Endpoint.

     -d "client_id=YOUR_CLIENT_ID" \

     -d "response_type=code" \

     -d "redirect_uri=YOUR_REDIRECT_URI" \

     -d "scope=required_scope1 required_scope2" \

     -d "state=YOUR_STATE_STRING"

Upon successful authorization and user consent, you'll be redirected to the redirect_uri you provided, and an authorization code will be appended as a query parameter. Step 2: Exchange Authorization Code for Token Once you have received the authorization code, you need to exchange it for an access token by calling the Token Endpoint.

     -d "grant_type=authorization_code" \

     -d "code=RECEIVED_AUTHORIZATION_CODE" \

     -d "redirect_uri=YOUR_REDIRECT_URI" \

     -d "client_id=YOUR_CLIENT_ID" \

     -d "client_secret=YOUR_CLIENT_SECRET"

This will return an access_token and a refresh_token. Step 3: Refresh the Token Your access_token will be valid for 1 hour. To get a new one without requiring the user to log in again, use the refresh_token.

     -d "grant_type=refresh_token" \

     -d "refresh_token=YOUR_REFRESH_TOKEN" \

     -d "client_id=YOUR_CLIENT_ID" \

     -d "client_secret=YOUR_CLIENT_SECRET"

By following these steps, your ISV application can securely interact with Schneider Electric's API services, with the proper authorizations in place.

Support

Contact our Exchange support team at exchange.support@se.com and include,

- Endpoint URL

- Request/Response of the URL

- Any additional information like Screenshots, Postman collections

Get help from the community here.