平台开放了以下5类接口供开发者调用;
其中:设备类接口的“向设备下发指令”是用来控制设备的接口,是最常用,也是最重要的;
在“第4节 命令下发”中,有对此接口的详细说明。
如果您仅需控制少量设备,可以大致浏览后跳过本节。
另外需要注意的是,在私有化场景中,因为设备不再连接平台,需开发者自行实现设备管理与控制。
接口采用HTTP协议,使用任何可进行HTTP请求的编程语言均可;
接口调用的方法也完全一致,对于不同的设备,调用方式可复用,仅命令不同。因此:
如仅控制设备:
可以只封装一个函数,将设备ID(整形)和命令(数组)作为参数传入
如需其他管理操作:
可以封装一个类,将设备控制、分组、定时任务等做为类的方法
接口调用
接口地址:
https://api.yoyoiot.cn/{AppID}/{接口列表中的path}/?{其他参数}&sign={sign}&ts={ts}
{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位数字
返回信息格式
接口分类

3.1 设备类接口

fdsafdsafdsa
名称 功能
向设备下发指令 控制设备,向设备下发指令 文档
获取设备列表 获取设备列表 文档
获取设备详情 获取设备详情 文档
维护设备标签 当存在很多设备时,您可能需要通过标签来将标记设备,一台设备可以关联多个标签。 文档
维护设备分组 可以将设备添加到分组,统一管理 文档
获取设备日志 获取设备日志列表 2025-02-24新增,现征求开发者意见。接口完全明确后,会取消此备注。 文档

3.2 产品类接口

名称 功能
获取产品列表 获取平台和自定义产品列表 文档
获取自有产品列表 获取已有(存量)设备的产品列表 文档

3.3 分组类接口

名称 功能
获取分组列表 获取设备分组列表 文档
创建分组 文档
修改分组 文档
删除分组 文档
执行命令或动作 控制分组执行命令或动作 文档

3.4 标签类接口

名称 功能
获取标签列表 获取标签列表 文档
创建标签 文档
修改标签 修改标签 文档
删除标签 删除标签 文档
执行命令或动作 控制标签执行命令或动作 文档

3.5 任务类接口

名称 功能
获取任务列表 读取当前控制台的任务列表 文档
任务创建 创建一个任务 文档
任务详情 获取任务的详情信息 文档
修改任务 修改任务信息 文档
删除任务 删除任务 文档
控制任务 控制任务的启停 文档