平台开放了以下5类接口供开发者调用;
其中:设备类接口的“向设备下发指令”是用来控制设备的接口,是最常用,也是最重要的;
在“第4节 命令下发”中,有对此接口的详细说明。
如果您仅需控制少量设备,可以大致浏览后跳过本节。
另外需要注意的是,在私有化场景中,因为设备不再连接平台,需开发者自行实现设备管理与控制。
其中:设备类接口的“向设备下发指令”是用来控制设备的接口,是最常用,也是最重要的;
在“第4节 命令下发”中,有对此接口的详细说明。
如果您仅需控制少量设备,可以大致浏览后跳过本节。
另外需要注意的是,在私有化场景中,因为设备不再连接平台,需开发者自行实现设备管理与控制。
接口采用HTTP协议,使用任何可进行HTTP请求的编程语言均可;
接口调用的方法也完全一致,对于不同的设备,调用方式可复用,仅命令不同。因此:
接口调用的方法也完全一致,对于不同的设备,调用方式可复用,仅命令不同。因此:
如仅控制设备:
可以只封装一个函数,将设备ID(整形)和命令(数组)作为参数传入如需其他管理操作:
可以封装一个类,将设备控制、分组、定时任务等做为类的方法接口调用
接口地址:
https://api.yoyoiot.cn/{AppID}/{接口列表中的path}/?{其他参数}&sign={sign}&ts={ts}
{AppID} 为您的应用ID(由平台生成)请按准备工作的引导进入控制台,在开发设置页面查看。
{接口列表中的path} 为接口路径,如下发命令的路径为 device/control
{其他参数} 为允许get方式传入的参数,如lang=cn,则在错误返回时使用中文
{AppID} 为您的应用ID(由平台生成)请按准备工作的引导进入控制台,在开发设置页面查看。
{接口列表中的path} 为接口路径,如下发命令的路径为 device/control
{其他参数} 为允许get方式传入的参数,如lang=cn,则在错误返回时使用中文
请求方式:POST 【建议】 一些简单的命令,也可以使用GET方式
必传的参数
参数 | 名称 | 说明 |
---|---|---|
sign | 签名 |
所有请求物联网控制台接口,均需在url中携带此参数sign={sign} 取值方法:{sign} = md5(md5(开发者密码) + 上面的ts参数),32位字符串 |
ts | 时间戳 |
所有请求物联网控制台接口,均需在url中携带此参数ts={timestap} 取值方法:{ts} = 请求时间(timezone,东八区),10位数字 |