Category     

Enterprise Cloud Manager API 2.0 Overview

« Go Back

Information

 
Content

Enterprise Cloud Manager APIv2


Quick Links

Summary

Instructions

Related Articles


Summary

The Enterprise Cloud Manager API is an interface for developers to use to integrate their systems and/or scripts with the data available in Enterprise Cloud Manager. This includes online/offline status of routers and network interfaces, signal strength and quality of cellular modems, router logs, and much more.

Developers are often looking to integrate the data collected by Enterprise Cloud Manager into their internal network monitoring systems, log parsing applications, or network inventory management systems. The ECM API provides a robust interface for integrating these systems.

The ECM API is an RESTful HTTP interface that returns data in JSON format. This article will instruct you how to sign up for the ECM API, manage your keys, and access additional documentation and code examples in the API portal.


Instructions

To authenticate to the ECM API you will need to include 2 pairs of keys in the headers of your HTTP request:

X-ECM-API-ID
X-ECM-API-KEY

X-CP-API-ID
X-CP-API-KEY

To create these keys and access the API portal, follow these instructions:

  • Step 1: Log in to Enterprise Cloud Manager.
  • Step 2: From the Applications tab, click the "Sign Up" button on the ECM API tile(first time only). This will sign you up for the ECM API and the tile will reload.
User-added image
  • Step 3: Click on the "Manage" button on the ECM API tile.
User-added image
  • Step 4: From the ECM API Manage page click "Add" to create a new pair ECM API Keys.
User-added image
  • Step 5: Select the account or subaccount you want the keys to have access to, then select the permission level (read only, full access, or administrator), then click OK.
User-added image
  • Step 6: These are the X-ECM-API-ID and X-ECM-API-KEY. Copy the ECM API keys into a safe place. **NOTE: This is the only time you will be able to see the "Secret" or X-ECM-API-KEY. It will not be viewable again after clicking OK.
User-added image
  • Step 7: Click "Back" to go back to the ECM Applications page.
User-added image
  • Step 8: Click "API Portal" on the ECM API tile to open the API Portal.
User-added image
  • Step 9: On this page are displayed the X-CP-API-ID and X-CP-API-KEY keys. Copy the CP API keys into a safe place.
User-added image

You have now successfully created both pairs of keys. You will need to include both pairs in your HTTP headers when making an API call. For additional documentation and code examples, click on "Documentation" at the top of the API portal.

User-added image


Related Articles/Links


Published Date: 11/02/2015

This article not have what you need?  Not find what you were looking for?  Think this article can be improved?  Please let us know at suggestions@cradlepoint.com
 


 
Knowledge Home | Product