ESP32玩转HTTP请求:GET取数POST上报一次讲透

2026-11-13 13:28:02 91阅读 所属项目:ESP32 开发板

ESP32 HTTP GET 与 HTTP POST 教程封面

上周把家里那块 ESP32 接上温湿度计之后,我就一直在琢磨一件事:怎么把读数送到别的地方去。上次写过一篇 MQTT 的玩法,走的是订阅发布的路子。这次换个更"直来直去"的方案——HTTP 请求。它更像是网页浏览的逻辑:你发一个请求,服务器回一个响应,一来一回就结束。

HTTP 是客户端和服务器之间的请求-响应协议。对 ESP32 来说,最常见的两个动作就是:把传感器读数上报给某个服务,或者从某个接口拉数据回来。这篇用的是 Arduino IDE 的 HTTPClient 库,三个实验从 GET 到 POST 一路跑通,底稿出自 Random Nerd Tutorials 的经典教程,代码原样搬来,可以直接抄。

GET 和 POST 到底怎么分工

先讲概念再动手,能少走很多弯路。GET 用来向指定资源请求数据,常见于从 API 拿值。它的参数直接拼在网址里,比如这样:

GET /update-sensor?temperature=value1

也就是说,查询字符串(参数名 temperature 和值 value1)是直接放在 URL 里的,人人都看得见。也可以只发一个简单请求,让对方返回一个值或一段 JSON:

GET /get-sensor

POST 则相反,用来向服务器发送数据、创建或更新资源,比如上报传感器读数。数据不放在网址里,而是装进请求体:

POST /update-sensor HTTP/1.1
Host: example.com
api_key=api&sensor_name=name&temperature=value1&humidity=value2&pressure=value3
Content-Type: application/x-www-form-urlencoded

请求体里也可以直接塞一个 JSON 对象:

POST /update-sensor HTTP/1.1
Host: example.com
{api_key: "api", sensor_name: "name", temperature: value1, humidity: value2, pressure: value3}
Content-Type: application/json

一句话记住区别:GET 的数据暴露在 URL 里,POST 的数据藏在请求体里。但注意,如果不上 HTTPS 加密,POST 的内容在网络传输中依然是可见的,只是不在网址栏里晃悠而已。顺带补一句和 MQTT 的关系:MQTT 是长连接加主题订阅,适合设备一直在线互相推消息;HTTP 是一次性请求响应,适合定时上报和拉取,两者不冲突,按场景挑就行。

准备工作:板子、库和一个本地服务

开工前准备三样东西。第一,ESP32 开发板一块,Arduino IDE 里装好 ESP32 支持包。第二,安装 Arduino_JSON 库,在库管理器搜 Arduino_JSON 装上即可,第二个实验解析 JSON 要用。

第三,一个能收请求的目标服务。底稿教程用树莓派跑 Node-RED 当作本地"假 API":树莓派 IP 加 1880 端口打开编辑器,导入作者提供的流程。流程里一共有三个 HTTP 端点——update-sensor 负责收上报,get-sensor 负责吐回一段 JSON,长这个样子:

Node-RED 流程:get 与 post 共三个 HTTP 端点

没有树莓派也不要紧,ThingSpeak、IFTTT WebHooks、OpenWeatherMap 这类服务都能对接,只要照着它们的 API 文档改掉服务器地址和参数就行。

实验一:GET 把读数塞进网址上报

第一个实验让 ESP32 每 5 秒发一次 GET 请求,把一个示例温度值拼在网址后面发给 Node-RED。整个流程就是 ESP32 发出 GET、服务端回一个 200 状态码:

ESP32 用 GET 把温度拼进网址上报的示意

先把代码里两处改成你自己的:WiFi 名称密码,还有 serverName 里的树莓派 IP:

// Replace with your network credentials
const char* ssid     = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
String serverName = "http://192.168.1.106:1880/update-sensor";

核心动作在 loop 里:把参数拼到 serverName 后面,http.begin 挂上目标地址,然后 http.GET 发出去:

String serverPath = serverName + "?temperature=24.37";

// Your Domain name with URL path or IP address with path
http.begin(serverPath.c_str());

// If your need Node-RED/server authentication, insert user and password below
//http.setAuthorization("REPLACE_WITH_SERVER_USERNAME", "REPLACE_WITH_SERVER_PASSWORD");

// Send HTTP GET request
int httpResponseCode = http.GET();

提示:如果 Node-RED 设了账号密码,把下面这行注释解开,填上用户名密码即可:

// If you need Node-RED/server authentication, insert user and password below
//http.setAuthorization("REPLACE_WITH_SERVER_USERNAME", "REPLACE_WITH_SERVER_PASSWORD");

ESP32 实际请求的完整网址长这样,温度 24.37 就挂在问号后面:

http://192.168.1.106:1880/update-sensor?temperature=24.37

请求发完,响应码和返回内容都从同一批接口里取,别忘了 http.end() 释放资源:

if (httpResponseCode>0) {
  Serial.print("HTTP Response code: ");
  Serial.println(httpResponseCode);
  String payload = http.getString();
  Serial.println(payload);
}
else {
  Serial.print("Error code: ");
  Serial.println(httpResponseCode);
}

烧录后打开 Node-RED 的调试窗口,就能看到 24.37 这个值每 5 秒刷一次进来。

实验二:GET 拉回 JSON 再拆开

第二个实验反过来:ESP32 主动向 get-sensor 接口要数据,服务端直接回一个 JSON 对象:

ESP32 用 GET 拉回 JSON 对象的示意

解析要用到开头装的 Arduino_JSON 库。服务器地址改成 get-sensor:

String serverName = "http://192.168.1.106:1880/get-sensor";

loop 里调用 httpGETRequest 函数发请求,这个函数把整个请求流程封装好了:

String httpGETRequest(const char* serverName) {
  HTTPClient http;

  // Your IP address with path or Domain name with URL path 
  http.begin(serverName);

  // If you need Node-RED/server authentication, insert user and password below
  //http.setAuthorization("REPLACE_WITH_SERVER_USERNAME", "REPLACE_WITH_SERVER_PASSWORD");


  // Send HTTP POST request
  int httpResponseCode = http.GET();

  String payload = "{}"; 

  if (httpResponseCode>0) {
    Serial.print("HTTP Response code: ");
    Serial.println(httpResponseCode);
    payload = http.getString();
  }
  else {
    Serial.print("Error code: ");
    Serial.println(httpResponseCode);
  }
  // Free resources
  http.end();

  return payload;
}

拿回的字符串用 JSON.parse 解析,先判断类型是不是 undefined 防止解析失败,然后遍历所有键取值,存进数组:

JSONVar myObject = JSON.parse(sensorReadings);

// JSON.typeof(jsonVar) can be used to get the type of the var
if (JSON.typeof(myObject) == "undefined") {
  Serial.println("Parsing input failed!");
  return;
}

Serial.print("JSON object = ");
Serial.println(myObject);

// myObject.keys() can be used to get an array of all the keys in the object
JSONVar keys = myObject.keys();

for (int i = 0; i < keys.length(); i++) {
  JSONVar value = myObject[keys[i]];
  Serial.print(keys[i]);
  Serial.print(" = ");
  Serial.println(value);
  sensorReadingsArr[i] = double(value);
}
Serial.print("1 = ");
Serial.println(sensorReadingsArr[0]);
Serial.print("2 = ");
Serial.println(sensorReadingsArr[1]);
Serial.print("3 = ");
Serial.println(sensorReadingsArr[2]);

烧录后串口监视器收到的原始数据长这样,三个值分别对应温度、湿度和气压:

{"value1":24.25,"value2":49.54,"value3":1005.14}

解析之后逐个打印,就变成了规规矩矩的三行读数,调试窗口里同样能看到这次请求的痕迹。

实验三:POST 的三种姿势

第三个实验是重头戏:同一个 serverName,用 POST 发三种格式的请求体——URL 编码、JSON 对象、纯文本,一次说全:

HTTP POST 三种请求体格式的示意

地址还是上报用的 update-sensor:

String serverName = "http://192.168.1.106:1880/update-sensor";

姿势一,URL 编码表单。请求体用 ampersand 连接的键值对,内容类型是 application/x-www-form-urlencoded,对应的原始请求长这样:

POST /update-sensor HTTP/1.1
Host: 192.168.1.106:1880
api_key=tPmAT5Ab3j7F9&sensor=BME280&value1=24.25&value2=49.54&value3=1005.14
Content-Type: application/x-www-form-urlencoded

代码层面就三步:http.begin 挂地址,addHeader 声明内容类型,http.POST 把数据字符串发出去:

// Your Domain name with URL path or IP address with path
http.begin(serverName);

// If you need Node-RED/server authentication, insert user and password below
//http.setAuthorization("REPLACE_WITH_SERVER_USERNAME", "REPLACE_WITH_SERVER_PASSWORD");

// Specify content-type header
http.addHeader("Content-Type", "application/x-www-form-urlencoded");

// Data to send with HTTP POST
String httpRequestData = "api_key=tPmAT5Ab3j7F9&sensor=BME280&value1=24.25&value2=49.54&value3=1005.14";

// Send HTTP POST request
int httpResponseCode = http.POST(httpRequestData);

姿势二,JSON 对象。换一行头声明,再把 JSON 字符串直接塞给 POST。注意 C 代码里的引号要转义:

http.addHeader("Content-Type", "application/json");

int httpResponseCode = http.POST("{\"api_key\":\"tPmAT5Ab3j7F9\",\"sensor\":\"BME280\",\"value1\":\"24.25\",\"value2\":\"49.54\",\"value3\":\"1005.14\"}");

姿势三,纯文本。内容类型换成 text/plain,想发什么字符串都行:

http.addHeader("Content-Type", "text/plain");

int httpResponseCode = http.POST("Hello, World!");

提示:教程里的 Node-RED 流程只配了收前两种格式,纯文本那种要看你对接的 API 是否支持。烧录后调试窗口每 5 秒收到一次 POST,三个示数还顺带送进了仪表盘:

Node-RED 仪表盘展示三个传感器读数

收个尾:这套玩法能用在哪

三个实验跑下来,ESP32 的 HTTP 请求基本就通了。GET 拼参数拉数据,POST 装请求体上报,两种方法覆盖了绝大多数网络服务和 API 的用法。落到实际项目里:定时把温湿度推到 ThingSpeak 画曲线、调用 IFTTT 的 WebHooks 触发手机提醒、从自己的数据库接口拉配置,都是同一套代码换个地址的事。

对接新服务时的通用套路就三步:翻对方的 API 文档,确认服务器地址(域名或 IP 加路径),确认参数放 URL 还是请求体,然后把本文例子里对应的位置改掉就行。周末花一个下午,就能让家里那块 ESP32 正式接入你的数据链路。


作者:工位上的小周
链接:https://www.aiddithome.com/p/6a181c2033af2.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
阿伟不emo
1楼 · 2026-11-13 13:30:27

GET 和 POST 的区别这段讲得很清楚,之前一直糊里糊涂地混着用,现在记住了:参数拼网址用 GET,装请求体用 POST。

电烙铁爱好者
2楼 · 2026-11-13 13:30:27

上周刚用 MQTT 推过温湿度数据,看完这篇打算试试 HTTP 版本,定时上报的场景感觉 HTTP 写起来更省事,不用维护长连接。

板砖搬不动
3楼 · 2026-11-13 13:30:27

提醒一下后面玩的朋友,POST 走 http 明文的话数据其实是裸奔的,接公网服务最好还是上 HTTPS,局域网里折腾倒无所谓。

调参到凌晨
4楼 · 2026-11-13 13:30:27

对接 ThingSpeak 那段太实用了,我就是把例子里 serverName 一改直接推上云了,曲线当天就画出来了,零门槛。