This guide will step you through the process of getting started with OpenGate North and South APIs.
First, apply for yours IoT Identifiers
You have to ask to the OpenGate Platform administrator to obtain:
-
Admin Information:(This information is not necessary to perform most of the operations with the API because this is obtained internally by the API through the API Key)
-
Your Organization Identifier (or Customer Id)
-
A Channel Identifier in which the device will be grouped
-
If you have your own OpenGate platform in your site, you can use the Organization and Channel identifiers that are provisioned with the default installation of the Platform: * Organization: base_organization * Channel: base_channel or create new ones: |
-
A Device Identifier: As an string that will identify the device into a Organization. We will use in the examples:
my_device
If the user (API_KEY) you have, has enough permissions on the organization you can provision the devices using North API provision. See how to provision devices. Remember to use your own device id. |
Then, obtain a valid API Key
In both cases (North and South API) you have to ask to the OpenGate Platform administrator for two different API Keys. One for applications (North) API and one for devices (South) API.
If you have enough permissions you can create new users (with their respective API Keys. See how to provision users |
The API Key is a unique identifier all over the platform generated by the administrator which uses the UUID format
This identifier looks like:
5d16e447-5398-482e-9779-b4184d937a41
Start using the APIs
Attending that OpenGate are based in a well known technologies as HTTP and JSON, there is a large of resources and programming languages that can be used: Java, JavaScript, perl, Phyton, .Net, C, C++, etc.
To a quick start we propose using CURL that is a widely used tool to perform most types of WebService Interactions from a command line console. You can find a lot of documentation about CURL tool in its project home page
If you’re using a Linux flavour, CURL is probably already installed.
If you’re using windows you can find a ported version here or you can install the fantastic Cygwin.].
If you are not familiar with CURL and you have an Internet OpenGate API access try hurl.
Send IoT information from a device to the platform
Use the South API from a specific device to write and store data. See how to collect IoT information from devices
Send DMM information from a device to the platform
Use the South API from a specific device to write and store data. See how to collect DMM information from devices
Retrieve IoT Collected Information
Use the North API from your applications in order to read the data sent from a specific device.See how to search collected IoT information
Retrieve DMM Collected Information
Use the North API from your applications in order to read the data sent from a specific device. See how to search collected DMM information