# HTTP 请求

使用 HTTP/HTTPS Api

HTTP API 允许您通过任何服务或 DIY 智能项目向 iotBind 平台发送和接收请求。当向 HTTP 请求发出时, 您的请求必须使用 Device API 密钥进行签名，并包含请求参数，并使用 HTTP 方法 GET 或 POST。API 版本 1.0 的基本 URL 是：

```
 http://api.iotbind.com/v1/  
```

> 要生成 API 密钥，请点击密钥图标。添加设备后，点击刷新图标生成新密钥。随时生成新密钥。

```
URL API：http://api.iotbind.com/v1/switch.php

```

| 参数 | 值 | 描述 |
| --- | --- | --- |
| method | "POST" 或 "GET"  | 用于发送数据的方式，仅支持值“post”或“get”，必须始终使用它 |
| uid | Device UniqueID | 始终使用它 |
| key | 加密密钥 | Device API 密钥，始终使用它 |
| cmd | "on" "off" "get" "ping" 中的一个 | 发送请求到 iotbind 时，仅使用这些命令中的一个："on" 如果您想将 on 命令发送到设备；"off" 如果您想将 off 命令发送到设备；"get" 如果您想从 iotBind 平台获取所有设备数据；"ping" 如果您想将 ping 命令发送到 iotBind 平台以了解设备是否已连接 |
| data1 | 文本或数字 | (可选) 仅用于更新 data1 |
| data2 | 文本或数字 | (可选) 仅用于更新 data2 |
| data3 | 文本或数字 | (可选) 仅用于更新 data3 |

示例：如果需要发送 "on" 命令并更新 data1、data2、data3 通过 URL 链接 "GET 方法":

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

替换:{DeviceKay} = API Device Kay{UniqueID} = Device UniqueID{Anything} = 任何您需要的数据

输出 JSON 数据:

 

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

 * data1、data2、data3 是可选的，如果您需要更新数据。

示例：如果需要通过 "GET 方法" 获取开关数据：

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



替换:{DeviceKay} = API Device Kay{UniqueID} = Device UniqueID

输出 JSON 数据 :

 *  

如果想要发送 "ping" 命令到 iotBind 平台以了解设备是否已连接，可以通过 URL 链接 "POST 方法":

http://api.iotbind.com/v1/switch.php

发送 POST 数据请求:method=post

uid=UniqueID

key=Device Kay

cmd=ping

输出 JSON 数据 :  

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

如果想要通过 URL 链接 "GET 方法" 发送 "ping" 命令：http://api.iotbind.com/v1/switch.php?method=get&key={DeviceKay}&uid={UniqueID}&cmd=ping替换:{DeviceKay} = API Device Kay{UniqueID} = Device UniqueID输出 JSON 数据 :

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