OneNET Studio 北向接入指南（HTTP推送及API调

一：前言：

一般是在OneNET Studio南向对接完成，设备数据可以上报到平台后才开始进行Studio的北向对接。北向对接分为数据推送和API调用。前者是OneNET Studio将设备上传的数据和设备状态等信息主动推送到应用服务器。后者是应用服务器调用OneNET Studio开放的API接口实现命令下发，设备管理等功能。

二：PHP接口代码

（注）储存的URL填入图8的推送地址

<?php
$result=file_get_contents("php://input"); //接收onenet平台推送过来是数据，后面自己处理
//file_put_contents("get.txt",$result);//将数据暂时缓存到get.txt文件中
echo $_GET['msg']; // 返回msg值给onenet,告诉它,我收到了,如果你不告诉它,它会在第2000次没收到之后，把你拉黑

三：HTTP数据推送

在应用开发-项目管理里新建项目，如图1所示。

图1 添加一个项目 图2 填写项目信息g

填写项目信息。如图2所示。

图3 进入项目管理

进入项目管理，如图3所示。之后进行设备添加操作。如图4和图5所示。

图4 向项目添加设备 图5 选择产品及下面的设备 图6 设备已经添加到该项目下 图7 添加一个HTTP推送实例

在应用开发-数据推送里面添加一个HTTP推送实例。配置之前需要参考开发文档，在接收服务器开发部署好接收程序。

HTTP推送开发文档：<u>https://open.iot.10086.cn/doc/iot_platform/book/application-develop/push/http_push.html</u>

HTTP推送配置如图8所示。验证如图9和图10所示。

图8 HTTP推送实例配置 图9 HTTP推送验证 图10 HTTP推送验证成功

如果验证失败，则需要检查服务器的网络或者接收程序是否正确返回msg及200状态码，返回是否超时。

回到项目管理-规则引擎里，可以选择设备的哪些数据，可以被推送到哪里。这里把目的地设置为之前创建的HTTP推送实例。如图11和图12所示。

图11 添加推送的规则引擎 图12配置一个规则引擎

至此当设备有数据上报或者在线状态变化，OneNET Studio都会实时的将数据按照规则引擎把数据推送到该HTTP数据推送的服务器。

四：API调用

API开发文档：<u>https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html</u>

平台也有API的在线调试，如图13所示。

图13 选择API进行调试

平台会调用接口执行，同时右侧会生成相应的代码，供开发者参考，如图14所示。

图14 生成的相应代码 图15 调用设备创建的API生成的设备