13. ESP32-HTTPClient(Arduino)

使用ESP32 Arduino框架的HTTPClient库进行HTTP请求

在ESP32开发里，网络通信是挺重要的一部分，你可能需要从服务器拿数据啊，或者把传感器数据发到云端什么的。不过别担心，ESP32 Arduino框架给我们提供了HTTPClient库，让HTTP请求轻松简单。这篇文章就是来告诉你怎么在ESP32上利用HTTPClient库做HTTP请求的。

步骤一：包含必要的库

首先，在你的Arduino项目中，你需要包含HTTPClient库。打开Arduino IDE，点击顶部菜单栏中的"工具"，然后选择"管理库"。在库管理器中搜索"HTTPClient"，点击安装。
在这里插入图片描述

步骤二：初始化WiFi连接

在进行HTTP请求之前，需要确保ESP32已连接到WiFi网络。使用WiFi库来初始化WiFi连接，对WiFi库不了解的博友可以看一下这篇文章 7. ESP32-WIFI(Arduino)。

#include <WiFi.h>const char* ssid = "你的WiFi网络名称";
const char* password = "你的WiFi网络密码";void setup() {Serial.begin(115200);WiFi.begin(ssid, password);while (WiFi.status() != WL_CONNECTED) {delay(1000);Serial.println("正在连接到WiFi...");}Serial.println("已连接到WiFi网络");
}

步骤三：发起HTTP请求

一旦连接到WiFi网络，就可以使用HTTPClient库来发起HTTP请求了。

发起get请求

下面是如何详细发起HTTP get请求的：

创建HTTPClient对象： 首先，你需要创建一个HTTPClient对象。这个对象将负责处理HTTP请求和响应。
```
HTTPClient http;
```
开始HTTP会话： 使用HTTPClient对象的begin()方法来指定你要访问的URL。这个URL可以是一个完整的URL，比如http://example.com/data，或者是一个IP地址，比如http://192.168.1.100/data。
```
http.begin("http://example.com/data");
```
选择HTTP方法： HTTP请求有多种方法，最常见的是GET和POST。GET方法用于从服务器获取数据，而POST方法用于向服务器发送数据。在这个例子中，我们使用GET方法获取数据。
```
int httpResponseCode = http.GET();
```
处理响应： 一旦HTTP请求发送成功，服务器将会返回一个HTTP响应码。通常情况下，200表示成功。你可以使用http.GET()的返回值来获取响应码。
```
if (httpResponseCode > 0) {// HTTP请求成功
} else {// HTTP请求失败
}
```
获取服务器响应： 如果HTTP请求成功，你可以使用http.getString()来获取服务器返回的数据。如果服务器返回的是JSON格式的数据，你可以使用ArduinoJson库的方法来解析它关于ArduinoJson的详细内容可以看我的另一篇文章 ESP32-JSON(Arduino)。
```
String payload = http.getString();
```
结束HTTP会话： 当HTTP请求完成后，记得调用http.end()来结束HTTP会话，释放资源。
```
http.end();
```

#include <HTTPClient.h>const char* serverURL = "http://example.com/data"; // 更换为你的服务器地址void setup() {Serial.begin(115200);WiFi.begin(ssid, password);while (WiFi.status() != WL_CONNECTED) {delay(1000);Serial.println("正在连接到WiFi...");}Serial.println("已连接到WiFi网络");HTTPClient http;Serial.print("正在发送HTTP GET请求到：");Serial.println(serverURL);http.begin(serverURL);int httpResponseCode = http.GET();if (httpResponseCode > 0) {Serial.print("HTTP响应码：");Serial.println(httpResponseCode);String payload = http.getString();Serial.println("服务器响应：");Serial.println(payload);} else {Serial.print("HTTP GET请求失败，错误码：");Serial.println(httpResponseCode);}http.end(); // 结束HTTP连接
}void loop() {// 可选的其他代码
}

发起POST请求

不论是POST请求还是get请求，大致步骤都是相同的。下面的示例展示了如何发送一个POST请求，并接收并解析服务器返回的JSON格式数据。

创建HTTPClient对象并初始化会话：
```
HTTPClient http;
http.begin(serverURL);
```
设置请求头：
```
http.addHeader("Content-Type", "application/json");
```
"Content-Type": "application/json" 告诉服务器请求体的格式是JSON。

创建JSON请求体：

StaticJsonDocument<200> jsonDoc;
jsonDoc["key1"] = "value1";
jsonDoc["key2"] = "value2";
String requestBody;
serializeJson(jsonDoc, requestBody);

发送POST请求并获取响应码：

int httpResponseCode = http.POST(requestBody);

处理响应：

if (httpResponseCode > 0) {String response = http.getString();// 解析并处理JSON响应
} else {// 处理请求失败的情况
}

解析JSON响应：

StaticJsonDocument<200> responseJson;
DeserializationError error = deserializeJson(responseJson, response);
if (!error) {const char* value = responseJson["key"];
}

结束HTTP会话：
```
http.end();
```

const char* serverURL = "http://example.com/api"; // 替换为你的服务器地址void sendPostRequest() {if (WiFi.status() == WL_CONNECTED) {HTTPClient http;http.begin(serverURL);http.addHeader("Content-Type", "application/json"); // 设置请求头// 创建JSON请求体StaticJsonDocument<200> jsonDoc;jsonDoc["key1"] = "value1";jsonDoc["key2"] = "value2";String requestBody;serializeJson(jsonDoc, requestBody);// 发送POST请求int httpResponseCode = http.POST(requestBody);if (httpResponseCode > 0) {String response = http.getString();Serial.print("HTTP响应码：");Serial.println(httpResponseCode);Serial.println("服务器响应：");Serial.println(response);// 解析服务器返回的JSON响应StaticJsonDocument<200> responseJson;DeserializationError error = deserializeJson(responseJson, response);if (error) {Serial.print("解析JSON失败：");Serial.println(error.c_str());return;}// 提取数据并存储const char* value = responseJson["key"]; // 根据JSON中的键提取值Serial.print("从服务器返回的值是：");Serial.println(value);} else {Serial.print("HTTP POST请求失败，错误码：");Serial.println(httpResponseCode);}http.end(); // 结束HTTP连接} else {Serial.println("WiFi未连接");}
}void setup() {Serial.begin(115200);WiFi.begin(ssid, password);while (WiFi.status() != WL_CONNECTED) {delay(1000);Serial.println("正在连接到WiFi...");}Serial.println("已连接到WiFi网络");// 发送POST请求sendPostRequest();
}void loop() {// 可选的其他代码
}

结论

在ESP32 Arduino框架里，用HTTPClient库发HTTP请求超级简单又高效😄。就几个简单的步骤，你就能轻松地发起GET和POST请求，处理服务器的响应，连响应头和响应正文都能读📖。HTTPClient库特别灵活，再加上ArduinoJson库厉害的解析能力🔍，处理HTTP通信变得简直顺手无比👌。这招对物联网应用特别管用🌐，像远程数据收集、设备控制和数据传输之类的💪。