开放接口并支持对接的吸顶式高精度红外传感器

2026-05-30 发布浏览：710 次

芯步工厂提供的智能人体存在传感器[吸顶][红外版] 开放HTTP接口，适用于任何支持HTTP请求的编程语言。接口简单、清晰、友好，仅需在接口携带签名、以及设备ID，即可向设备下发命令。支持接入任何形式的软件项目：Web、APP / 小程序、窗体软件、以及SaaS / 低代码等平台。

本文介绍了智能人体存在传感器[吸顶][红外版]的相关参数和命令，并在下面提供了主要类型的语言的编程示例。

智能人体存在传感器[吸顶][红外版]

配置1个红外传感模块，探测距离5米内；

带1路电源输出，可接照明等电器，实现有人接通/无人断开（可自定义）；

人体存在探测发生变化时，实时上报状态到自定义服务器；

可与其他设备实现联动：

如探测到有人时，语音喇叭播报相关警示；

或探测到无人时，关闭相关插座电源等；

支持HTTP接口远程控制，支持自定义联动操作；

更多...

适用场景

智能家居人体感应控制、共享自习室人体存在检测、共享棋牌室人走断电控制、共享茶室安全节能管理、共享台球室人体感应控制、共享场所安全节能管理、智能办公人体存在检测、门店人走断电控制、设备机房人体感应管理、弱电间安全联动、无人值守空间人体存在检测、智能家居人体感应照明、智能办公人体存在监测、共享自习室人走断电控制、共享台球厅人体感应联动、共享茶室人体存在感应、共享棋牌室自动照明控制、共享充电场所人体感应、无人值守空间人体监测、店铺人体感应照明、设备机房人员活动监测、弱电间人体感应联动、智能化改造人体感应场景、酒店客房人体存在感应、民宿房间人体感应照明、共享健身房人体存在监测、共享充电站人体感应控制、智慧教室人体存在监测、培训机构教室人体感应、图书馆自习室人体存在感应、创客工坊人体活动监测、学校活动室人体感应照明、培训教室人体存在监测、餐厅包厢人体感应控制、便利店人体感应照明、银行网点人体存在监测、医院病房人体感应联动、展会现场人体感应照明、活动现场人体存在监测、工厂车间人体活动监测、仓储仓库人体感应控制、园区公共区域人体感应、写字楼办公室人体存在监测、商场店铺人体感应照明、社区公共区域人体感应、实验室人体存在监测、办公设备人体感应联动

支持命令

红外模块	infrared_enable
线路	power

产品手册

版本	对应产品手册
白色	《智能人体存在红外传感器[吸顶]产品手册》

控制设备，向设备下发指令

HTTP请求地址： http(s)://api.yoyoiot.cn/{AppID}/device/control/?sign={sign}&ts={ts} 关于sign和ts的定义

或

MQTT发布主题： api/{AppID}/device/control 接收返回结果亦在同一主题

请求参数

参数较长时建议使用POST方式

名称	必填	类型	说明
gateway	否	string	当发给设备的命令需要其关联的网关转发时，需要指定网关的设备ID，唯一ID（在网关壳体上、控制台均可以找到）指定多个网关时请用间隔符(,或\|)连接，最多可以同时指定5台网关
device	是	string	设备ID，设备唯一ID（在设备壳体上、控制台均可以找到）指定多台设备时请用间隔符(,或\|)连接指定多个设备时，不要这些设备属于同一类产品，但必须有相同的指令
order	是	string	命令，可传JSON字符串(推荐)或直接传参简单命令：可直接GET或POST：设备的属性名称=属性值复杂或较长的命令：请POST {"order":{命令内容}} ----------------------------------------------------------------------- 在一些业务场景，需要在命令里携带一些特征信息：如订单号等可在order中增加一个字段extra，如{"power":1,"extra":"T25030700001"} 在本条命令对应的异步消息推送中，会原样返回此特征信息。 extra只支持32位以内的大小写英文字母和数字（a-zA-Z0-9）

返回示例

​x
 
//示例
//device为设备唯一id
//p1、p2为参数名称，v1、v2为参数的值
​
//GET方式的参数为：
?device=123456&p1=v1&p2=v2&sign={sign}&ts={ts}
​
//POST方式的FORM参数为：
device=123456
p1=v1
p2=v2
​
//POST方式的JSON参数为：
{"device":111,"order":{"p1":"v1","p2":"v2"}}

返回结果

需要注意的是，200仅代表平台接收到了合规的设备ID与参数名称，并成功向设备下发命令。

而设备可能已离线，或命令内容 / 参数有误，在设备上并没有看到预期效果。

在一些必须要求反馈的场景，请接收云端的消息推送，通过异步消息来标记设备是否成功执行命令。

名称	类型	说明
code	int	200 命令下发成功。 501 未指定设备ID，设备ID为一个整型数字，或由“\|”或“,"连接的多个数字。设备列表接口中输出了此ID，在本控制台的设备列表中也可以查看。 502 设备不存在或没有可用设备，传入设备ID均不存在。请检查设备ID是否正确，设备是否删除。 503 指定了过多设备，一次最多指定100台设备ID 504 一次指定了多个设备ID，但其中有一些并不可用（不存在、无权限或已删除） 50xx 请见“全局错误代码”