HTTP API

Best HTTP Rules engine built-in with Thingsup IoT Platform to create HTTP APIs. Validate and Transform your IoT data on the fly with serverless service to build your IoT solutions.

HTTP Rule is a Rule defined in Thingsup to Process HTTP Request. User need to provide following parameters.

URL

HTTP Rules can be executed by sending HTTP POST Request to below URL.

https://api.thingsup.io/data/{Your-AccountID}/{Rule-ID}

Authorization - Auth key

It is an Authorization Key for incoming HTTP Request. This Key needs to be sent in Authorization header in HTTP POST Request with format Bearer{space}{Your-Auth-Key} to https://api.thingsup.io/data/{Your-AccountID}/{Rule-ID}

Bearer<space>{Your-Auth-Key}

Data Validation/Transform

Here user can write a JavaScript code to validate or change data i.e "payload" which is received in body of HTTP Request.

The "payload" object here in this code which can be changed or transformed before passing to Thingsup Actions. Also user can assign "null" to payload if he want to avoid action trigger after data validation.

// This code checks if payload is JSON and contains Location data
if(typeof payload === 'object')
{
if(payload.Location == undefined)
{
payload = null;
}
else
{
payload["time"] = Date.now(); // Transform payload
}
}
else
{
payload = null;
}

Action ID

User need to provide an Action ID of Action to be triggered.

Add HTTP Rule

Please note the following points:

  • "null" payload results into Rule Failure which doesn't trigger Action

  • Avoid using Rule Engine directly to trigger Send SMS/Email Action, bad configuration can result into High Credits Usage

  • Content Types of JSON, Form Data and x-www-form-urlencoded are supported