IoTbind Docs IoTbind Docs

HTTP 请求

MD html

使用 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”，必须始终使用它
uidDevice 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" }