OneNET HTTP协议的使用

最新推荐文章于 2025-07-07 10:28:02 发布

Sanjay_Wu

最新推荐文章于 2025-07-07 10:28:02 发布

阅读量2.3w

点赞数 15

CC 4.0 BY-SA版权

分类专栏： IOT OneNET云平台文章标签： OneNET HTTP RESTful

本文链接：https://blog.youkuaiyun.com/Sanjay_Wu/article/details/84870419

IOT 同时被 2 个专栏收录

20 篇文章

订阅专栏

OneNET云平台

14 篇文章

订阅专栏

本文详细介绍如何使用OneNET平台的HTTP协议进行数据上报和获取，包括使用TCP&UDP测试工具进行调试的方法，以及使用C语言代码实现数据流的POST和GET操作。通过实际案例，读者可以了解到如何连接OneNET平台，POST数据流，以及如何GET数据流。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言

在OneNET平台的HTTP协议可以说是最简单的一种协议，使用的是HTTP的RESTful风格接口，可以作为新手用来入门OneNET各类协议的协议。在OneNET它是一种短连接协议，只能用于数据上报，不能下发命令，如果你想要实现命令下发可以用EDP协议或者MQTT协议。本文向将用工具调试方法，再用C语言代码讲解，用socket来通信，不贴出socket代码，代码在另外一篇博客OneNET的EDP协议讲解与应用有贴出。本文只POST、GET一个数据流或一个数据点，读者若想实现多个数据流或数据点的POST、GET，可参考本文代码，并参考OneNET HTTP协议开发文档。

一、用TCP&UDP测试工具调试

1、工具下载

可以到TCPUDP测试工具下载，或者直接百度搜索“TCP&UDP测试工具”下载。

2、连接服务器

（1）打开工具，输入服务器IP地址和端口，OneNET HTTP协议对应的服务器IP为：183.230.40.33，端口为：80。

（2）点击连接

3、POST数据流

POST /devices/505619290/datapoints HTTP/1.1
api-key:SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=
Host:api.heclouds.com
Content-Length:66

{"datastreams":[{"id":"test_stream","datapoints":[{"value":28}]}]}

设备ID：505619290
api-key:SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=
Content-Length:66，66的长度为：{"datastreams":[{"id":"test_stream","datapoints":[{"value":28}]}]} 的长度
Content-Length:66 下面一定要换行。
数据流名称:test_stream
数据流值：28

成功之后，在对应设备可以看到：

4、GET数据流

GET http://api.heclouds.com/devices/505619290/datapoints?datastream_id=test_stream HTTP/1.1
api-key:SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=
Host:api.heclouds.com

设备ID：505619290
api-key:SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=
Host:api.heclouds.com之后要有两个换行\r\n\r\n

由下图可在成功GET数据：

二、用C语言讲解OneNET HTTP协议的使用

1、连接OneNET平台

OneNET HTTP协议对应的服务器IP为：183.230.40.33，端口为：80。代码如下：

typedef enum
{
	HTTP_SRV_CONNECT_OK = 0,
	HTTP_SRV_CONNECT_ERROR = 1
}http_srv_connect_t;

char *g_onenet_http_srv_ip_addr = "183.230.40.33";
int   g_onenet_http_srv_ip_port = 80;

/* socket id */
int g_onenet_http_socket_id = -1;

/**************************************************************
函数名称 : onenet_http_service_connect
函数功能 : 连接OneNET平台
输入参数 : ip_addr：ip地址，ip_port：端口
返回值  	 : HTTP_SRV_CONNECT_OK:连接成功，
		   HTTP_SRV_CONNECT_ERROR：连接失败
备注		 : 无
**************************************************************/
http_srv_connect_t onenet_http_service_connect(char *ip_addr, int ip_port)
{
	g_onenet_http_socket_id = socket_create();
	
	if(g_onenet_http_socket_id < 0)
	{
		ONENET_HTTP_LOG("connect failed, g_onenet_mqtt_socket_id < 0");
		return HTTP_SRV_CONNECT_ERROR;
	}

	if(CONNECT_ERROR == socket_connect_service(g_onenet_http_socket_id, ip_addr, ip_port))
	{
		ONENET_HTTP_LOG("connect failed, connect error");
		return HTTP_SRV_CONNECT_ERROR;
	}
	else
	{
		ONENET_HTTP_LOG("connect success");
		return HTTP_SRV_CONNECT_OK;
	}
	
}

/* 连接OneNET平台 */
if(HTTP_SRV_CONNECT_OK == onenet_http_service_connect(g_onenet_http_srv_ip_addr, g_onenet_http_srv_ip_port))
{
    ONENET_HTTP_LOG("connect success");
}
else
{
    ONENET_HTTP_LOG("connect failed");
}

2、POST数据流到设备

代码如下：

typedef enum
{
	HTTP_POST_OK = 0,
	HTTP_POST_ERROR = 1
}http_post_t;

char *g_onenet_http_pro_api_key = "SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=";
char *g_onenet_http_dev_id = "505619290";

/* 数据流 */
int data_point = 18;
char *data_stream_name = "temperature";

/**************************************************************
函数名称 : onenet_http_post_data_stream
函数功能 : post OneNET平台
输入参数 : 无
返回值  	 : HTTP_POST_OK:发送POST成功，
		   HTTP_POST_ERROR：发送POST失败
备注		 : 无
**************************************************************/
http_post_t onenet_http_post_data_stream(char *dev_id, char *api_key)
{
	char post_buf[ONENET_HTTP_POST_MAX_LEN];
	char post_content[ONENET_HTTP_POST_CONTENT_MAX_LEN];
	char post_content_len[4];
	
	memset(post_content, 0, sizeof(post_content));
	memset(post_buf, 0, sizeof(post_buf));
	
	sprintf(post_content,"{\"datastreams\":[{\"id\":\"%s\",\"datapoints\":[{\"value\":%d}]}]}",data_stream_name, data_point);
	sprintf(post_content_len,"%d",strlen(post_content));
		
	strcat(post_buf, "POST /devices/");
	strcat(post_buf, dev_id);
	strcat(post_buf, "/datapoints HTTP/1.1\r\n");
	strcat(post_buf, "api-key:");
	strcat(post_buf, api_key);
	strcat(post_buf, "\r\n");
	strcat(post_buf, "Host:api.heclouds.com\r\n");
	strcat(post_buf, "Content-Length:");
	strcat(post_buf, post_content_len);
	strcat(post_buf, "\r\n\r\n");
	strcat(post_buf, post_content);
	strcat(post_buf, "\r\n\r\n");

	if(socket_send(g_onenet_http_socket_id, post_buf, strlen(post_buf)) > 0)
	{
		return HTTP_POST_OK;
	}
	else
	{
		return HTTP_POST_ERROR;
	}
}

/* POST数据流 */
if(HTTP_POST_OK == onenet_http_post_data_stream(g_onenet_http_dev_id, g_onenet_http_pro_api_key))
{
    ONENET_HTTP_LOG("post success");
}
else
{
    ONENET_HTTP_LOG("post failed");
}

POST成功之后，在拼平台对应设备可以查看到：

3、获取平台下发的结果

代码如下：

TaskHandle_t g_onenet_http_device_recv_pro_task_handle = NULL;	

/**************************************************************
函数名称 : onenet_http_device_recv_pro
函数功能 : 平台返回数据检测处理
输入参数 : data：平台返回的数据
返回值  	 : 无
备注		 : 无
**************************************************************/
void onenet_http_device_recv_pro(unsigned char *dataPtr)
{
	uart_printf("%s", dataPtr);/* 将平台下发的结果通过串口打印出来 */
}

#define ONENET_MQTT_RECV_MAX_SIZE	1024
/**************************************************************
函数名称 : onenet_http_device_recv_pro_task
函数功能 : 接收onenet下发数据处理任务函数
输入参数 : pvParameter：任务入口参数
返回值  	 : 无
备注		 : 无
**************************************************************/
void onenet_http_device_recv_pro_task(void *pvParameter)
{
	unsigned char data_ptr[ONENET_MQTT_RECV_MAX_SIZE];
		
	memset(data_ptr, 0, sizeof(data_ptr));
	
	while(1)
	{
		if(socket_receive(g_onenet_http_socket_id, data_ptr, ONENET_MQTT_RECV_MAX_SIZE) > 0)	//使用MSG_DONTWAIT会比较稳定
		{
			onenet_http_device_recv_pro(data_ptr);	//集中处理
			memset(data_ptr, 0, sizeof(data_ptr));
		}	
		vTaskDelay(1);	
	}
}
/**************************************************************
函数名称 : onenet_http_device_recv_pro_task_init
函数功能 : 创建接收onenet下发数据处理任务
输入参数 : 无
返回值  	 : 无
备注		 : 无
**************************************************************/
void onenet_http_device_recv_pro_task_init(void)
{
	if(g_onenet_http_device_recv_pro_task_handle == NULL) {
            xTaskCreate(onenet_http_device_recv_pro_task,
                            "onenet_http_device_recv_pro_task",
                            1024 * 4 / sizeof(portSTACK_TYPE),
                            NULL,
                            TASK_PRIORITY_NORMAL,
                            &g_onenet_http_device_recv_pro_task_handle);
            ONENET_HTTP_LOG("onenet_http_device_recv_pro_task");
        }

}

串口打印POST的结果如下：

4、GET数据流

代码如下：

char *g_onenet_http_pro_api_key = "SlxhH3MCLvuuvXJ0N=a14Yo6EAQ=";
char *g_onenet_http_dev_id = "505619290";

char *get_data_stream_name = "test_stream";

/**************************************************************
函数名称 : onenet_http_get_data_stream
函数功能 : GET OneNET平台数据流
输入参数 : 无
返回值  	 : HTTP_GET_OK：发送GET成功
		   HTTP_GET_ERROR：发送GET失败
备注		 : 无
**************************************************************/
http_get_t onenet_http_get_data_stream(char *dev_id, char *api_key)
{
	char get_buf[ONENET_HTTP_GET_MAX_LEN];
	
	memset(get_buf, 0, sizeof(get_buf));
		
	strcat(get_buf, "GET http://api.heclouds.com/devices/");
	strcat(get_buf, dev_id);
	strcat(get_buf, "/datapoints?datastream_id=");
	strcat(get_buf, get_data_stream_name);
	strcat(get_buf, " HTTP/1.1\r\n");
	strcat(get_buf, "api-key:");
	strcat(get_buf, api_key);
	strcat(get_buf, "\r\n");
	strcat(get_buf, "Host:api.heclouds.com\r\n");
	strcat(get_buf, "\r\n\r\n");

	if(socket_send(g_onenet_http_socket_id, get_buf, strlen(get_buf)) > 0)
	{
		return HTTP_GET_OK;
	}
	else
	{
		return HTTP_GET_ERROR;
	}
}

/* GET数据流 */
if(HTTP_GET_OK == onenet_http_get_data_stream(g_onenet_http_dev_id, g_onenet_http_pro_api_key))
{
    ONENET_HTTP_LOG("get success");
}
else
{
    ONENET_HTTP_LOG("get failed");
}

串口打印GET的结果如下：