To understand the main difference between these two ways of communication with your server, you need to understand the way the Sigfox Cloud has been built.
On Sigfox Cloud a company is usually represented by a "Group", in which each "Device type" can be attributed to a "family" of devices. All units of the same product will be grouped as a device type to allow all of them to behave exactly in the same way when a message is received by the Sigfox network.
This is represented in the diagram below:
Each device type can generate "Callbacks" to push data to your server when a message is received by our network from one of the devices of this device type.
Callbacks are HTTP requests which are one way only, as they are generated by our server and sent to your servers instantly upon receipt of a message from the emitting device.
We also set up a Rest API mechanism which works at Group level and is bi-directional. Integrating our API into your applications will allow you to request data from our servers, data that comes from the devices registered on our network, at any time you need it.
This will also allow you to manage, deploy and declare all of your devices on the Sigfox Cloud platform, completely automatically, thus removing the necessity to connect continuously to our Cloud platform to perform recurring operations such as callback declarations, device management, etc. This is used by our customers to handle the huge volume of devices they register on our network, directly from their platform.
Callbacks are available through device types as they will be activated every time any device of this device type sends a message. The callback menu is available by clicking on the "Device type" tab, and then clicking on any device type you have. The callback menu will appear on the left.
If you select the callback menu and click on "new" in the top right corner, different options will appear.
There are 2 types of callback : The "built-in" callback where some of our partner platforms are natively integrated, and the "Custom" callback where you can integrate your own.
Today the platforms that are available “natively” are:
This list is evolving.
If you wish to instantly send incoming messages to your private server or to a custom service, you will have to complete information regarding the service (is it for UPLINK or DOWNLINK?, the URL pattern, payload parameters etc...).
By doing so you will be able to process data sent from the device server-side and render the information gathered intelligibly for the end user (after decoding the hexadecimal frame).
Below is a document describing callback configuration in details.
After setting up the HTTP Callbacks, you will quickly be able to retrieve messages on your private application. But..
- How do you manage your huge list of devices ?
- How can you automatically register new devices when customers activate them ?
- How can you know there is Sigfox coverage at a designated location ?
We have built a very powerful REST API which will allow you to automate every required action. This was done to allow our customers to completely manage the Sigfox aspects of their business autonomously from their own platforms.
To access this API, you need to create an API Access token for yourself. To do so, click on your group, and navigate to the "API Access" tab on the left.
Below is a document describing the different endpoints available and how to access them.