In this article
Categories

Posting data to AlphaX with HTML Webhook

Print

Posting Data to AlphaX is a relatively simple process. The user must format his/her data in the correct format and simply POST it to the provided URL. The AlphaX system will automatically take care of the rest!

NOTE: The user must first enable Conduit using his/her user profile. Follow this article here for help: https://minnovation.com.au/knowledge-base/how-to-enable-conduit-for-a-user/

The user must also enable the HTTP Webhook checkbox on the Conduit feature.

The user can now post the the HTTP webhook using the following URL: https://app.alphax.cloud/conduitv4/post

Conduit Parameters:

token [REQUIRED]: The unique security token for each user. This is available from the User window in AlphaX. This parameter is required to access the conduit service, if confused about how to get token, please contact the Minnovation Team.
id [REQUIRED]: The unique network ID that is used to register and track the device in the AlphaX system. This parameter is mandatory, if not defined, you will receive an error message.
data[REQUIRED]: The byte array that contains the data for the POST. The data must assume the standard data format for AlphaX as documented here: https://minnovation.com.au/knowledge-base/payload/

date[OPTIONAL]: The 13 character timestamp in UTC time. This is the actual time of the data. If omitted the system will assume the datestamp as the time the data is received.

Example Usage:
https://app.alphax.cloud/conduitv4/post?token=xxxxxxxxxxxxxxxxxxxxxxx&id=mydevice1234&data=0A10010001000000A00F0000

This would submit the data

Fixed Data Channels: 4106 1 1 0

Being default data of Battery Voltage, Message ID, RSSI and Error Code. If your device doesn’t output these values simply add a 0 to pad the data value out.

Dynamic Data Channels: 4000

Being dynamic data channel of 4000. Note this value is divided by 1000 to convert to a float on storage.

Dynamic channels can be registered in AlphaX using the following link: https://minnovation.com.au/knowledge-base/how-to-configure-channel-for-an-alphax-iot-device/