Management API
Motivation
Management API is a RESTful interface designed to provision devices to the network server. Besides devices it allows to filter message stream coming from Data API by creating Filters. Also it allows to create and connect Adapters to the 3rd party IoT services: PubNub, AWS MQTT, MyDevices, MQTT, Azure IoT Hub, etc.
Endpoint URLs
Everynet is opearting different regions and private, including generale EU and US regions. Each region use it's own endpoint URL.
Custom regions and private networks could get endpoint URLs Everynet support.
https://ns.eu.everynet.io/api/v1.0 - European Region
https://ns.us.everynet.io/api/v1.0 - United States Region
The "Try it out section" is currently under construction and not working.
Features
Management API expose the following endpoints:
Users - CRUD operations for NS users. Permissions could be assigned to each user to limit information and action availability for the users.
Keys - CRUD operations for NS API Keys. Keys are used to authenticate clients to Data API and Management API. Permissions could be assigned to each key as well, so it it possible to limit data stream from Data API for each single key.
Permissions - designed to restrict permissions for different users and keys. For example Join Server should have access to the join messages, but do not have access to the ordinary data messages.
Devices - device provisioning and de-provisioning.
Bands - regional bands management, each band includes detailed information on radio parameters and timing (delay) constants that are used to transmit message from NS to Devices.
Filters - CRUD operations for the filters. Filters are designed to filter device message stream by applications, gateways, tags, devices and message types. All parameters are comma separated strings.
You should do the following to use a filter:- Create filter using Management API or GUI and memorize
filter_id
. - Establish a Data API connection using a querystring with parameter
filter
and valuefilter_id
, wherefilter_id
is a filter identifier memorized on the first step.
- Create filter using Management API or GUI and memorize
Connections - CRUD operation for the Connections between NS and 3rd party IoT platforms: MyDevices, AWS MQTT, PubNub, or any HTTP server.
Examples
curl -X GET "http://ns.eu.everynet.io/api/v1.0/users?access_token=9ec85978f3fa1ab6f953406269f69a95" -H "accept: application/json"