ESP32 S3 - Requête HTTP

L'ESP32 S3 dispose d'un Wi-Fi intégré qui lui permet de fonctionner facilement comme client HTTP — en envoyant des requêtes à des serveurs web, des API REST et des services web. Ce tutoriel vous montre comment effectuer des requêtes HTTP GET et POST depuis l'ESP32 S3, y compris comment joindre des données de capteur à ces requêtes et comment traiter la réponse du serveur.

Ce que vous allez construire :

  1. Un croquis ESP32 S3 qui se connecte au Wi-Fi et envoie une requête HTTP GET à un serveur distant ou un point de terminaison d'API
  2. Un croquis qui inclut des données de capteur en direct (température et humidité) dans la chaîne de requête HTTP d'une requête GET
  3. Un croquis qui envoie des données de capteur dans le corps d'une requête HTTP POST en utilisant des données de formulaire encodées en URL
  4. Un exemple complet et fonctionnel qui lit la réponse HTTP et affiche la réponse du serveur sur le moniteur série de l'Arduino IDE
Client web ESP32 S3
ESP32 S3 requête HTTP - envoyer des données GET et POST de l'ESP32 S3 vers un serveur web

Concepts de base du client web et du serveur web

Comprendre quelques concepts HTTP fondamentaux facilite grandement la création de requêtes fiables depuis l'ESP32 S3. Les idées clés incluent la structure de l'URL (nom d'hôte et chemin), les chaînes de requête pour transmettre des données, les méthodes HTTP (GET contre POST), et comment le code de réponse du serveur vous indique si la requête a réussi. Vous pouvez en apprendre plus à ce sujet dans le tutoriel HTTP.

Comment effectuer une requête HTTP

Les étapes suivantes montrent les éléments de base nécessaires pour envoyer une requête HTTP depuis l'ESP32 S3 en utilisant les bibliothèques intégrées WiFi et HTTPClient.

  • Inclure les bibliothèques
#include <WiFi.h> #include <HTTPClient.h>
  • Déclarer le SSID et le mot de passe du WiFi
const char WIFI_SSID[] = "YOUR_WIFI_SSID"; // CHANGE IT const char WIFI_PASSWORD[] = "YOUR_WIFI_PASSWORD"; // CHANGE IT
  • Déclarer le nom d'hôte, le chemin, la chaîne de requête
String HOST_NAME = "http://YOUR_DOMAIN.com"; // CHANGE IT String PATH_NAME = "/products/arduino"; // CHANGE IT //String PATH_NAME = "/products/arduino.php"; // CHANGE IT String queryString = "temperature=26&humidity=70"; // OPTIONAL
  • Déclarer un objet client HTTP
HTTPClient http;
  • Si connecté au serveur, envoyer une requête HTTP. Par exemple, HTTP GET :
http.begin(HOST_NAME + PATH_NAME); //HTTP int httpCode = http.GET();
  • Lire les données de réponse du serveur web
// httpCode will be negative on error if (httpCode > 0) { // file found at server if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); } else { // HTTP header has been send and Server response header has been handled Serial.printf("[HTTP] GET... code: %d\n", httpCode); } } else { Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end();

Comment inclure des données dans une requête HTTP

Envoyer des relevés de capteur ou d'autres valeurs à un serveur web nécessite d'encoder ces données dans la requête HTTP. La bonne approche dépend de si vous utilisez GET ou POST : les requêtes GET transportent les données dans la chaîne de requête de l'URL, tandis que les requêtes POST placent les données dans le corps de la requête et peuvent prendre en charge des formats autres que les chaînes de requête, comme JSON ou XML.

Les étapes ci-dessous montrent comment envoyer des données au format chaîne de requête pour les deux méthodes.

  • Créer une chaîne de requête
int temp = // from sensor int humi = // from sensor String queryString = String("temperature=") + String(temp) + String("&humidity=") + String(humi);
  • HTTP GET : ajouter la chaîne de requête au chemin
http.begin(HOST_NAME + PATH_NAME + "?" + queryString); http.addHeader("Content-Type", "application/x-www-form-urlencoded"); int httpCode = http.GET();
  • HTTP POST : mettre la chaîne de requête dans le corps HTTP
http.begin(HOST_NAME + PATH_NAME); http.addHeader("Content-Type", "application/x-www-form-urlencoded"); int httpCode = http.POST(queryString);
  • Pour GET et POST, lire les données de réponse du serveur web
// httpCode will be negative on error if (httpCode > 0) { // file found at server if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); } else { // HTTP header has been send and Server response header has been handled Serial.printf("[HTTP] GET/POST... code: %d\n", httpCode); } } else { Serial.printf("[HTTP] GET/POST... failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end();

Code ESP32 S3

Code ESP32 S3 complet pour effectuer une requête HTTP

Le croquis suivant est le code ESP32 S3 complet pour effectuer une requête HTTP GET ou POST. Il se connecte à votre réseau Wi-Fi, ouvre une connexion HTTP vers l'hôte et le chemin configurés, envoie la requête, lit la réponse du serveur, et affiche le résultat sur le moniteur série. Remplacez les identifiants et l'URL d'exemple avant de téléverser.

/* * Ce code ESP32 S3 a été développé par newbiely.fr * Ce code ESP32 S3 est mis à disposition du public sans aucune restriction. * Pour des instructions complètes et des schémas de câblage, veuillez visiter: * https://newbiely.fr/tutorials/esp32-s3/esp32-s3-http-request */ /* * This ESP32-S3 code is created by esp32io.com * * This ESP32-S3 code is released in the public domain * * For more detail (instruction and wiring diagram), visit https://esp32io.com/tutorials/esp32-s3-http-request */ #include <WiFi.h> #include <HTTPClient.h> const char WIFI_SSID[] = "YOUR_WIFI_SSID"; // CHANGE IT const char WIFI_PASSWORD[] = "YOUR_WIFI_PASSWORD"; // CHANGE IT String HOST_NAME = "http://YOUR_DOMAIN.com"; // CHANGE IT String PATH_NAME = "/products/arduino"; // CHANGE IT //String PATH_NAME = "/products/arduino.php"; // CHANGE IT void setup() { Serial.begin(115200); WiFi.begin(WIFI_SSID, WIFI_PASSWORD); Serial.println("Connecting"); while(WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println(""); Serial.print("Connected to WiFi network with IP Address: "); Serial.println(WiFi.localIP()); HTTPClient http; http.begin(HOST_NAME + PATH_NAME); //HTTP int httpCode = http.GET(); // httpCode will be negative on error if(httpCode > 0) { // file found at server if(httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); } else { // HTTP header has been send and Server response header has been handled Serial.printf("[HTTP] GET... code: %d\n", httpCode); } } else { Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end(); } void loop() { }

Étapes rapides

  1. Nouveau sur l'ESP32 S3 ? Suivez d'abord notre guide ESP32 S3 - Premiers pas.
  2. Connectez la carte ESP32 S3 à votre PC à l'aide d'un câble USB Type-C.
  3. Ouvrez l'Arduino IDE sur votre PC.
  4. Dans l'Arduino IDE, sélectionnez la bonne carte (ESP32S3 Dev Module ou équivalent) et le bon port COM sous Tools.
Comment téléverser le code ESP32 S3 avec Arduino IDE
  1. Copiez le croquis ci-dessus et ouvrez-le dans l'Arduino IDE.
  2. Mettez à jour YOUR_WIFI_SSID et YOUR_WIFI_PASSWORD avec les identifiants de votre réseau.
  3. Mettez à jour HOST_NAME et PATH_NAME avec l'adresse du serveur et le point de terminaison que vous souhaitez atteindre.
  4. Cliquez sur le bouton Upload pour compiler et flasher le croquis sur l'ESP32 S3.
  5. Une fois le téléversement terminé, ouvrez le moniteur série depuis le menu Tools ou l'icône du moniteur.
Comment ouvrir le moniteur série sur Arduino IDE
  1. Réglez le débit en bauds sur 115200 dans le menu déroulant du moniteur série.
  2. Observez le moniteur série pour le statut de la connexion Wi-Fi et la réponse HTTP du serveur.
  3. Astuce pro : Si la requête échoue avec un code d'erreur négatif, vérifiez que votre ESP32 S3 est à portée du Wi-Fi et que le serveur cible est accessible depuis votre réseau — les pare-feu et les points de terminaison exclusivement HTTPS sont des causes fréquentes d'échec de connexion.

Explication du code ligne par ligne

Le code ESP32 S3 ci-dessus contient une explication ligne par ligne. Veuillez lire les commentaires dans le code !

Sortie du moniteur série

Lorsque l'ESP32 S3 se connecte avec succès au Wi-Fi et termine une requête HTTP, le moniteur série affichera une sortie similaire à la suivante :

∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32S3 Dev Module
Newbiely.ino
···
8 Serial.println("Hello World!");
Output
Serial Monitor
Message (Enter to send message to 'ESP32S3 Dev Module' on 'COM15')
New Line
9600 baud
[2026-06-16 10:22:01] Connecting to WiFi... [2026-06-16 10:22:04] WiFi connected. IP: 192.168.1.105 [2026-06-16 10:22:04] Sending HTTP GET request... [2026-06-16 10:22:05] HTTP Response Code: 200 [2026-06-16 10:22:05] Response: {"status":"ok","message":"Data received"} [2026-06-16 10:22:15] Sending HTTP GET request... [2026-06-16 10:22:16] HTTP Response Code: 200 [2026-06-16 10:22:16] Response: {"status":"ok","message":"Data received"}
Ln 11, Col 1
ESP32S3 Dev Module on COM15
2

Code ESP32 S3

Code ESP32 S3 complet pour effectuer une requête HTTP GET avec des données

Le croquis suivant étend l'exemple HTTP de base en lisant des valeurs de capteur et en les ajoutant sous forme de chaîne de requête à l'URL de la requête GET. C'est un modèle courant pour enregistrer des données environnementales comme la température et l'humidité vers un serveur distant ou une plateforme IoT.

/* * Ce code ESP32 S3 a été développé par newbiely.fr * Ce code ESP32 S3 est mis à disposition du public sans aucune restriction. * Pour des instructions complètes et des schémas de câblage, veuillez visiter: * https://newbiely.fr/tutorials/esp32-s3/esp32-s3-http-request */ /* * This ESP32-S3 code is created by esp32io.com * * This ESP32-S3 code is released in the public domain * * For more detail (instruction and wiring diagram), visit https://esp32io.com/tutorials/esp32-s3-http-request */ #include <WiFi.h> #include <HTTPClient.h> const char WIFI_SSID[] = "YOUR_WIFI_SSID"; // CHANGE IT const char WIFI_PASSWORD[] = "YOUR_WIFI_PASSWORD"; // CHANGE IT String HOST_NAME = "http://YOUR_DOMAIN.com"; // CHANGE IT String PATH_NAME = "/products/arduino"; // CHANGE IT //String PATH_NAME = "/products/arduino.php"; // CHANGE IT String queryString = "temperature=26&humidity=70"; void setup() { Serial.begin(115200); WiFi.begin(WIFI_SSID, WIFI_PASSWORD); Serial.println("Connecting"); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println(""); Serial.print("Connected to WiFi network with IP Address: "); Serial.println(WiFi.localIP()); HTTPClient http; http.begin(HOST_NAME + PATH_NAME + "?" + queryString); http.addHeader("Content-Type", "application/x-www-form-urlencoded"); int httpCode = http.GET(); // httpCode will be negative on error if (httpCode > 0) { // file found at server if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); } else { // HTTP header has been send and Server response header has been handled Serial.printf("[HTTP] GET... code: %d\n", httpCode); } } else { Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end(); } void loop() { }

Étapes rapides

  1. Nouveau sur l'ESP32 S3 ? Suivez d'abord notre guide ESP32 S3 - Premiers pas.
  2. Connectez la carte ESP32 S3 à votre PC à l'aide d'un câble USB Type-C.
  3. Ouvrez l'Arduino IDE sur votre PC.
  4. Copiez le croquis ci-dessus et ouvrez-le dans l'Arduino IDE.
  5. Mettez à jour les identifiants Wi-Fi et l'URL cible avec vos valeurs.
  6. Cliquez sur le bouton Upload pour flasher le croquis sur l'ESP32 S3.
  7. Ouvrez le moniteur série à 115200 bauds pour voir l'URL de la requête et la réponse du serveur.
  8. Astuce pro : Utilisez un service gratuit comme RequestBin ou Webhook.site pour capturer et inspecter la chaîne de requête exacte envoyée par votre ESP32 S3 — c'est un moyen simple de vérifier que les données sont correctement formatées avant de se connecter à votre véritable backend.

Explication du code ligne par ligne

Le code ESP32 S3 ci-dessus contient une explication ligne par ligne. Veuillez lire les commentaires dans le code !

Sortie du moniteur série

Lorsque le croquis GET-avec-données s'exécute sur l'ESP32 S3, le moniteur série affichera une sortie similaire à la suivante, montrant la chaîne de requête ajoutée à la requête et la réponse du serveur :

∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32S3 Dev Module
Newbiely.ino
···
8 Serial.println("Hello World!");
Output
Serial Monitor
Message (Enter to send message to 'ESP32S3 Dev Module' on 'COM15')
New Line
9600 baud
[2026-06-16 10:25:33] WiFi connected. IP: 192.168.1.105 [2026-06-16 10:25:33] GET /data?temperature=26&humidity=70 HTTP/1.1 [2026-06-16 10:25:34] HTTP Response Code: 200 [2026-06-16 10:25:34] Response: {"status":"ok","temp":26,"humi":70} [2026-06-16 10:25:44] GET /data?temperature=27&humidity=69 HTTP/1.1 [2026-06-16 10:25:45] HTTP Response Code: 200 [2026-06-16 10:25:45] Response: {"status":"ok","temp":27,"humi":69}
Ln 11, Col 1
ESP32S3 Dev Module on COM15
2

Code ESP32 S3

Code ESP32 S3 complet pour effectuer une requête HTTP POST avec des données

Le croquis suivant envoie des données de capteur à un serveur en utilisant une requête HTTP POST, plaçant les paires clé-valeur encodées en URL dans le corps de la requête plutôt que dans l'URL. POST est préféré pour envoyer des charges utiles plus volumineuses ou lorsque vous voulez garder les données hors des journaux d'accès du serveur.

/* * Ce code ESP32 S3 a été développé par newbiely.fr * Ce code ESP32 S3 est mis à disposition du public sans aucune restriction. * Pour des instructions complètes et des schémas de câblage, veuillez visiter: * https://newbiely.fr/tutorials/esp32-s3/esp32-s3-http-request */ /* * This ESP32-S3 code is created by esp32io.com * * This ESP32-S3 code is released in the public domain * * For more detail (instruction and wiring diagram), visit https://esp32io.com/tutorials/esp32-s3-http-request */ #include <WiFi.h> #include <HTTPClient.h> const char WIFI_SSID[] = "YOUR_WIFI_SSID"; // CHANGE IT const char WIFI_PASSWORD[] = "YOUR_WIFI_PASSWORD"; // CHANGE IT String HOST_NAME = "http://YOUR_DOMAIN.com"; // CHANGE IT String PATH_NAME = "/products/arduino"; // CHANGE IT //String PATH_NAME = "/products/arduino.php"; // CHANGE IT String queryString = "temperature=26&humidity=70"; void setup() { Serial.begin(115200); WiFi.begin(WIFI_SSID, WIFI_PASSWORD); Serial.println("Connecting"); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println(""); Serial.print("Connected to WiFi network with IP Address: "); Serial.println(WiFi.localIP()); HTTPClient http; http.begin(HOST_NAME + PATH_NAME); http.addHeader("Content-Type", "application/x-www-form-urlencoded"); int httpCode = http.POST(queryString); // httpCode will be negative on error if (httpCode > 0) { // file found at server if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); } else { // HTTP header has been send and Server response header has been handled Serial.printf("[HTTP] POST... code: %d\n", httpCode); } } else { Serial.printf("[HTTP] POST... failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end(); } void loop() { }

Étapes rapides

  1. Nouveau sur l'ESP32 S3 ? Suivez d'abord notre guide ESP32 S3 - Premiers pas.
  2. Connectez la carte ESP32 S3 à votre PC à l'aide d'un câble USB Type-C.
  3. Ouvrez l'Arduino IDE sur votre PC.
  4. Copiez le croquis ci-dessus et ouvrez-le dans l'Arduino IDE.
  5. Mettez à jour les identifiants Wi-Fi et l'URL du serveur avec vos valeurs.
  6. Cliquez sur le bouton Upload pour flasher le croquis sur l'ESP32 S3.
  7. Ouvrez le moniteur série à 115200 bauds pour confirmer que le POST a été envoyé et voir la réponse du serveur.
  8. Astuce pro : Réglez l'en-tête Content-Type sur application/json et formatez le corps comme une chaîne JSON si votre serveur ou point de terminaison d'API attend du JSON plutôt que des données de formulaire encodées en URL.

Explication du code ligne par ligne

Le code ESP32 S3 ci-dessus contient une explication ligne par ligne. Veuillez lire les commentaires dans le code !

Sortie du moniteur série

Lorsque le croquis POST-avec-données s'exécute sur l'ESP32 S3, le moniteur série affichera une sortie similaire à la suivante :

∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32S3 Dev Module
Newbiely.ino
···
8 Serial.println("Hello World!");
Output
Serial Monitor
Message (Enter to send message to 'ESP32S3 Dev Module' on 'COM15')
New Line
9600 baud
[2026-06-16 10:30:11] WiFi connected. IP: 192.168.1.105 [2026-06-16 10:30:11] POST body: temperature=26&humidity=70 [2026-06-16 10:30:12] HTTP Response Code: 200 [2026-06-16 10:30:12] Response: {"status":"ok","saved":true} [2026-06-16 10:30:22] POST body: temperature=27&humidity=68 [2026-06-16 10:30:23] HTTP Response Code: 200 [2026-06-16 10:30:23] Response: {"status":"ok","saved":true}
Ln 11, Col 1
ESP32S3 Dev Module on COM15
2

Applications et idées de projets

La capacité Wi-Fi de l'ESP32 S3 et la bibliothèque HTTPClient ouvrent un large éventail d'applications de connectivité réelles. Voici quelques pistes à explorer :

  1. Enregistreur de données IoT : Envoyez périodiquement des relevés de température, d'humidité ou d'autres capteurs vers une base de données cloud comme ThingSpeak ou InfluxDB via HTTP POST.
  2. Déclencheur de domotique : Envoyez une requête HTTP GET à un hub domotique (comme Home Assistant) pour basculer des lumières, des interrupteurs ou des scènes depuis un bouton physique câblé à l'ESP32 S3.
  3. Consommateur d'API REST : Interrogez une API publique de météo, de bourse ou de sport via HTTP et affichez la réponse JSON analysée sur un écran OLED ou LCD.
  4. Tableau de bord de capteurs : Envoyez en POST des données de capteur en direct vers un serveur web léger fonctionnant sur votre réseau local et affichez les relevés sur un tableau de bord dans un navigateur.
  5. Système d'alerte : Envoyez une requête HTTP à un service de messagerie (comme Pushover ou IFTTT) lorsqu'un seuil de capteur est dépassé — par exemple, une température élevée ou un événement de détection de mouvement.
  6. Notificateur de mise à jour du firmware : Interrogez un point de terminaison de serveur pour vérifier si une nouvelle version du firmware est disponible et affichez un avis à l'utilisateur avant de déclencher une mise à jour OTA.

Vidéo tutoriel

Regardez ci-dessous la vidéo pas à pas de ce projet ESP32 S3.

Défiez-vous

Une fois que la requête HTTP de base fonctionne sur votre ESP32 S3, il existe plusieurs façons d'approfondir votre compréhension et de créer des projets connectés au réseau plus performants. Essayez les défis ci-dessous par ordre de difficulté :

  1. Débutant : Modifiez le croquis pour afficher les en-têtes complets de la réponse HTTP sur le moniteur série en utilisant http.collectHeaders().
  2. Débutant : Ajoutez un bouton-poussoir physique à l'ESP32 S3 afin qu'une pression déclenche une requête HTTP GET au lieu d'un envoi sur minuterie.
  3. Intermédiaire : Analysez une réponse JSON du serveur en utilisant la bibliothèque ArduinoJson et affichez la valeur d'un champ spécifique sur le moniteur série.
  4. Intermédiaire : Mettez en œuvre une boucle de nouvelle tentative qui renvoie la requête HTTP jusqu'à trois fois si le serveur renvoie un code de statut différent de 200 ou si la connexion expire.
  5. Avancé : Passez de HTTP à HTTPS en utilisant WiFiClientSecure et une empreinte de certificat serveur, puis confirmez que l'ESP32 S3 peut atteindre un point de terminaison d'API sécurisé par TLS.
  6. Avancé : Créez un routeur de données multi-points qui lit deux capteurs différents et envoie en POST les données de chaque capteur vers un point de terminaison de serveur différent selon le type de capteur.

※ NOS MESSAGES

  • N'hésitez pas à partager le lien de ce tutoriel. Cependant, veuillez ne pas utiliser notre contenu sur d'autres sites web. Nous avons investi beaucoup d'efforts et de temps pour créer ce contenu, veuillez respecter notre travail !