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库不了解的博友可以看一下这篇文章 。

#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请求的：

#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格式数据。

1. 创建HTTPClient对象并初始化会话：

   HTTPClient http;
   http.begin(serverURL);
   

2. 设置请求头：

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

   "Content-Type": "application/json" 告诉服务器请求体的格式是JSON。

3. 创建JSON请求体：

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

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

   int httpResponseCode = http.POST(requestBody);
   

5. 处理响应：

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

6. 解析JSON响应：

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

7. 结束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通信变得简直顺手无比👌。这招对物联网应用特别管用🌐，像远程数据收集、设备控制和数据传输之类的💪。

参考资料