Using the HTTP/HTTPS Api
The HTTP API allows you to send and receive requests from any service or DIY Smart Project to iotBind platform.
When issuing a HTTP request, your request must be signed with Device API secret key , and include the request parameters and using the HTTP methods GET OR POST.

the base URL for API version 1.0  is : http://api.iotbind.com/v1/

To generate a API key , click on the key icon After adding the device And Click on the refresh icon To generate a new key Any time.

Switch

URL API : http://api.iotbind.com/v1/switch.php
Parameter Value Description
method "POST" or "GET"  For How you want to send data ,Only Value "post" or "get"
Always use it 
uid Device UniqueID
Always use it
key Encrypted key
Device API secret key
Always use it 
cmd One of these:
"on"
"off"
"get"
"ping"
only use one of these commands when you send a requests to iotbind
"on" If you want to send on Command to Device
"off" If you want to send off Command to Device
"get" If you want get all device data frome iotBind platform
"ping" If you want send ping Command to iotBind platform to learn that the device is connected
data1 Text or numbers
(optional) Use it only for update data1
data2 Text or numbers
(optional) Use it only for update data2
data3 Text or numbers
(optional) Use it only for update data3

Example: if you need to send "on" command and Update data1,data2,data3 by URL link "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=on&data1={Anything}&data2={Anything}&data3={Anything}

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID
{Anything} = any Data you need

Output json Data :
{"MESSAGE":"UPDATED"}

* data1,data2,data3 is an optional if you need to update data

Example: if you need to get switch data by "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=get

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID

Output json Data :
{
    "uid": "UniqueID",
    "name": "DeviceName",
    "type": "RGB Light",
    "cmd": "on",
    "data1": "Anything",
    "data1_unit": "Anything",
    "data2": "Anything",
    "data2_unit": "Anything",
    "data3": "Anything",
     "data3_unit": "Anything"
}

Example for send "off" command and Update data1,data2,data3 by URL link "POST method":
http://api.iotbind.com/v1/switch.php

Send POST data with request:
method=post
uid=UniqueID
key=DeviceKay
cmd=off
data1=Anything
data2=Anything
data3=Anything

Output json Data :
{"MESSAGE":"UPDATED"}

* data1,data2,data3 is an optional if you need to update data

Example: if you need to get switch data by "POST method:
http://api.iotbind.com/v1/switch.php

Send POST data with request:
method=post
uid=UniqueID
key=DeviceKay
cmd=get

Output json Data :
{
    "uid": "UniqueID",
    "name": "DeviceName",
    "type": "RGB Light",
    "cmd": "on",
    "data1": "Anything",
    "data1_unit": "Anything",
    "data2": "Anything",
    "data2_unit": "Anything",
    "data3": "Anything",
    "data3_unit": "Anything"
}

If you want send "ping" Command to iotBind platform to learn that the device is connected by URL link "POST method":
http://api.iotbind.com/v1/switch.php

Send POST data with request:
method=post
uid=UniqueID
key=DeviceKay
cmd=ping

Output json Data :
{"MESSAGE":"PING OK"}

If you want send "ping" Command to iotBind platform to learn that the device is connected by URL link "GET method":
http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=ping

replace:
{DeviceKay} = API Device Kay
{UniqueID} = Device UniqueID

Output json Data :
{"MESSAGE":"PING OK"}




need code ?

You can download and use the code and modify it for your project

Arduino firmware

NodeMCU Board
ESP8266 module

NudeMCU firmware Lua code

NodeMCU Board
ESP8266 module

Browse all supported programming languages

© Copyright 2024 iotBind - All Rights Reserved