# HTTP requests

> 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.

> 

URL API : http://api.iotbind.com/v1/sensor.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 keyAlways use it  |
| cmd | One of these:"get""ping" | only use one of these commands when you send a requests to iotbind"get" If you want get all sensor 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 | Use it only for update data1 |
| data2 | Text or numbers | Use it only for update data2 |
| data3 | Text or numbers | Use it only for update data3 |

Example: if you need to Update data1,data2,data3 by URL link "GET method":

```url
http://api.iotbind.com/v1/sensor.php?method=get&key={DeviceKay}&uid={UniqueID}&data1={Anything}&data2={Anything}&data3={Anything}  
```

replace:

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

Output json Data :

  

```json
{"MESSAGE":"UPDATED"}
```

* data1,data2,data3 is an optional if you need to update Any one of them  

Example: if you need to get sensor data by "GET method": 

```url
http://api.iotbind.com/v1/sensor.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=get 
```

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

Output json Data :  

```json
{
     "uid": "UniqueID",
     "name": "DeviceName",
     "type": "Motion Sensitive",
     "data1": "Anything",
     "data1_unit": "Anything",
     "data2": "Anything",
     "data2_unit": "Anything",
     "data3": "Anything",
     "data3_unit": "Anything"
}
```

Example: for Update data1,data2,data3 by URL link "POST method":

```url
http://api.iotbind.com/v1/sensor.php
```

Send POST data with request:method=postuid=UniqueIDkey=DeviceKaydata1=Anythingdata2=Anythingdata3=Anything  

Output json Data :

  

```json
{"MESSAGE":"UPDATED"}
```

* data1,data2,data3 is an optional if you need to update Any one of them

  

Example: if you need to get sensor data by "POST method:

```url
http://api.iotbind.com/v1/sensor.php
```

Send POST data with request:method=postuid=UniqueIDkey=DeviceKaycmd=get  

Output json Data :

  

```json
{
    "uid": "UniqueID",
    "name": "DeviceName",
    "type": "Motion Sensitive",
    "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":

```url
http://api.iotbind.com/v1/sensor.php
```

Send POST data with request:

method=postuid=UniqueIDkey=DeviceKaycmd=ping

Output json Data :

  

```json
{"MESSAGE":"PING OK"}
```

If you want send "ping" Command to iotBind platform to learn that the device is connected by URL link "GET method":

```url
http://api.iotbind.com/v1/sensor.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=ping  
```

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

Output json Data :

  

```json
{"MESSAGE":"PING OK"}
```