Overview:
A RESTful API is an application program interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. Currently cnMaestro On-Premises support API version 1 (v1) with HTTP requests to GET, PUT and POST. This API allows users to read data and perform operations programmatically using their own client applications. The API is supported over HTTPS, and messages are exchanged in JSON format.
The OAuth2.0 RESTful API supports device monitoring data for ePMP, PMP, and Wi-Fi, including Wi-Fi Clients. The API includes inventory, statistics, event, and alarm data.
Architecture:
A basic OAuth2 API session is presented below. The client retrieves an Access Token to start the session. It sends API requests until the Access Token times out, at which point the token can be regenerated.
This document will provide information on integrating API client (Postman) application to cnMaestro On-Premises to query required details.
Postman is available as a chrome extension and as an individual application.
https://chrome.google.com/webstore/category/extensions
Steps followed:
- OAuth 2.0 Access credentials Client ID and Client Secret are created while API Client is added on cnMaestro.
- Using these Access credentials on API Client (Postman) Access Token is generated.
- Using the Access Token further querying of details by GET, PUT and POST happens from Postman to cnMaestro.
Configuration on cnMaestro On-Premises:
On cnMaestro GUI navigate to Services >> API Clients and click on Add API Client.
Enter details to add API Client, with Name, Description, Expiration Time (Default is 3600 =1 hour), Concurrent Access of Access Tokens. Save the configuration.
Upon Saving the configuration, OAuth 2.0 Access Credentials are generated, Copy Client ID and Client Secret
We can also download the Access Credentials using Download Credentials option which will give in Json format file.
{
"application_name": "TestAPI",
"application_description": "Testing",
"client_id": "DOkn68AB4tji5lD1",
"client_secret": "KiPJCETaFBnLGEakmgNS6HlmhlnJOq"
}
Configuration on API Client (Postman) Application:
Open Postman application in your computer select Authentication Type as OAuth 2.0 and click on Get New Access Token.
Fill the details to get new Access Token. Token Name, Access Token URL, Client ID, Client Secret and select Grant Type : Client Credentials. Click on Request Token.
Access Token gets generated for the request. Choose Add Token to : Header and click on Use Token.
Now you can see as the Access Token under Header field.
Query based on your requirement, in this case we have performed a GET for the clients connected, click on Send and output is displayed in the Body.
Compare the output from cnMaestro GUI:
HTTP Response codes
Refer to available APIs supportability in the API Reference GUI.