
上周把家里那块 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-sensorPOST 则相反,用来向服务器发送数据、创建或更新资源,比如上报传感器读数。数据不放在网址里,而是装进请求体:
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,长这个样子:

没有树莓派也不要紧,ThingSpeak、IFTTT WebHooks、OpenWeatherMap 这类服务都能对接,只要照着它们的 API 文档改掉服务器地址和参数就行。
实验一:GET 把读数塞进网址上报
第一个实验让 ESP32 每 5 秒发一次 GET 请求,把一个示例温度值拼在网址后面发给 Node-RED。整个流程就是 ESP32 发出 GET、服务端回一个 200 状态码:

先把代码里两处改成你自己的: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 对象:

解析要用到开头装的 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 对象、纯文本,一次说全:

地址还是上报用的 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,三个示数还顺带送进了仪表盘:

收个尾:这套玩法能用在哪
三个实验跑下来,ESP32 的 HTTP 请求基本就通了。GET 拼参数拉数据,POST 装请求体上报,两种方法覆盖了绝大多数网络服务和 API 的用法。落到实际项目里:定时把温湿度推到 ThingSpeak 画曲线、调用 IFTTT 的 WebHooks 触发手机提醒、从自己的数据库接口拉配置,都是同一套代码换个地址的事。
对接新服务时的通用套路就三步:翻对方的 API 文档,确认服务器地址(域名或 IP 加路径),确认参数放 URL 还是请求体,然后把本文例子里对应的位置改掉就行。周末花一个下午,就能让家里那块 ESP32 正式接入你的数据链路。











GET 和 POST 的区别这段讲得很清楚,之前一直糊里糊涂地混着用,现在记住了:参数拼网址用 GET,装请求体用 POST。
上周刚用 MQTT 推过温湿度数据,看完这篇打算试试 HTTP 版本,定时上报的场景感觉 HTTP 写起来更省事,不用维护长连接。
提醒一下后面玩的朋友,POST 走 http 明文的话数据其实是裸奔的,接公网服务最好还是上 HTTPS,局域网里折腾倒无所谓。
对接 ThingSpeak 那段太实用了,我就是把例子里 serverName 一改直接推上云了,曲线当天就画出来了,零门槛。