Aprender

Un HTTP GET desde un ESP32: obtener el clima

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32-C3: obtén el climaen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
HTTPClient contra http://weather.mokxi/, en una red simulada. Cambia los números en la pestaña Cloud.

La mayoría de los proyectos conectados son una placa que pide un pequeño trozo de datos a un servidor y hace algo con él: el clima, la hora, una configuración. En un ESP32 dentro del mundo Arduino eso es la biblioteca HTTPClient, y el patrón siempre son los mismos cinco pasos: unirse a la red, iniciar una solicitud, hacer el GET, leer el cuerpo y terminar la solicitud.

El circuito de arriba es un ESP32-C3 corriendo el ejemplo integrado de WiFi: obtén el clima. Antes que nada, la parte honesta: la red en Mokxi es simulada. No hay radio y nada sale de tu pestaña del navegador a menos que inicies sesión y actives el internet real. Cuatro nombres inventados responden (time.mokxi, weather.mokxi, echo.mokxi y api.mokxi) y el código de la placa es el código que cargarías a un ESP32 real. Presiona Ejecutar y el monitor serie muestra los puntos del ciclo de conexión, luego "IP address: 192.168.4.2" y luego cada cinco segundos:

Cada obtención imprime "HTTP 200", luego el cuerpo, {"location":"Mokxi","temperatureC":21.5,"humidity":48,"simulated":true}, y luego los dos números que el sketch extrajo de él: "temperature: 21.5 C" y "humidity: 48 %".

Los cinco pasos

WiFi.begin(ssid, password) starts joining, and the sketch waits in a loop until WiFi.status() returns WL_CONNECTED. Then, for each request, it makes a WiFiClient and an HTTPClient, calls http.begin(client, url), and http.GET() sends the request and waits for the reply. GET returns the HTTP status code, 200 for success, and http.getString() returns the body. http.end() frees the connection.

Dos detalles importan en hardware real. Revisa el código antes de usar el cuerpo: un número negativo significa que la solicitud nunca se completó (sin red, un nombre que no resuelve, un tiempo de espera agotado) y un 404 o 500 significa que el servidor respondió con un error. Y siempre llama a end(), incluso después de una falla, para que la conexión y sus buffers se liberen antes de la siguiente solicitud; una placa que lo omite puede filtrar un poco de memoria con cada solicitud hasta que deja de funcionar.

firmware/examples/wifiweather (la solicitud, del programa que corre arriba)
WiFiClient client;
HTTPClient http;
http.begin(client, "http://weather.mokxi/");
int code = http.GET();
if (code <= 0) {
  Serial.print("request failed: ");
  Serial.println(HTTPClient::errorToString(code));
  http.end();
  return;
}
Serial.print("HTTP ");
Serial.println(code);
String body = http.getString();
http.end();

Extraer números del JSON

La respuesta es JSON, un formato de texto pequeño de nombres y valores. Este sketch busca el texto "temperatureC", se salta la comilla, los dos puntos y los espacios, y copia caracteres hasta la siguiente coma o llave de cierre. Eso basta para una respuesta plana que tú controlas, y mantiene el sketch legible. Para algo anidado o de un servicio de terceros, usa un analizador real; en una placa física la mayoría instala la biblioteca ArduinoJson.

Abre la pestaña Cloud junto a Serial mientras corre. Enumera cada solicitud que hizo la placa con su estado y cuerpo, y tiene dos campos para los números con los que responde weather.mokxi. Cambia la temperatura a 30 y la siguiente obtención, a lo más cinco segundos después, imprime "temperature: 30 C". Ese es el mismo viaje de ida y vuelta que hace una placa real a un servicio de clima real, con el servidor bajo tu control.

Cuando la solicitud falla

El sketch pide deliberadamente http://example.com/ una vez en setup(), y con el internet real apagado el monitor serie imprime la razón del fallo: no hay internet real, solo nombres bajo .mokxi. Una placa real sin ruta a un servidor falla en el mismo punto, en GET, con un código negativo, e imprimir HTTPClient::errorToString(code) es la forma más rápida de ver por qué.

Para practicar el manejo de errores del servidor, abre el ejemplo del laboratorio de API con el botón de abajo. Obtiene http://api.mokxi/data, y la pestaña Cloud te deja elegir el código de estado y el JSON que recibe. Ponlo en 404 o 500 y observa qué hace tu código con una respuesta que no esperaba. Las direcciones https:// fallan aquí a propósito, con un mensaje que dice que TLS no está simulado; en un ESP32 real una solicitud https necesita WiFiClientSecure y el certificado del servidor.

Hábitos que vale la pena cultivar

No preguntes con demasiada frecuencia. Un servicio de clima real se actualiza cada pocos minutos y muchos limitan cuántas veces puede llamarlos una misma clave; cada cinco segundos está bien contra weather.mokxi y es demasiado frecuente para la mayoría de los servicios reales. Una vez por minuto o menos es un valor por defecto cortés.

Mantén los secretos fuera del código compartido. Un sketch con una contraseña de WiFi o una clave de API adentro va a donde sea que lo pegues. Ponlos en un header aparte que no compartas, y cambia la contraseña de cualquier red cuyos datos hayan terminado en una publicación pública.

Un GET bloqueado bloquea todo. http.GET() espera la respuesta, así que mientras espera el sketch no lee botones ni actualiza una pantalla. En Mokxi una solicitud le cuesta al sketch su viaje de ida y vuelta simulado, como pasaría en hardware, y por eso un proyecto que debe mantenerse receptivo obtiene datos rara vez y hace su otro trabajo con millis() en lugar de delay().

Abre este circuito en el editor. ESP32-C3: obtén el clima, cableado tal como corre en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Preguntas

¿Qué placas pueden correr esto?

En Mokxi, las placas con radio en el hardware real: la ESP32-C3, la ESP32-C6, la clásica ESP32 DevKit, la ESP8266 NodeMCU y la Raspberry Pi Pico W. El mismo ejemplo viene para cada una de ellas.

¿Puede mi sketch llegar a un sitio web real desde el simulador?

Sí, una vez que inicies sesión. Activa Internet real en el panel Cloud, y las solicitudes HTTP y HTTPS a hosts reales salen por la pasarela de Mokxi. Con él apagado, solo resuelven los nombres bajo .mokxi, nada sale de la pestaña del navegador y cualquier otra cosa devuelve un error con una oración que explica por qué.

¿Qué significa el código HTTP -1 en un ESP32?

Que la conexión fue rechazada o no se pudo establecer: normalmente falta WiFi, una dirección equivocada o un servidor que no está ahí. HTTPClient::errorToString(code) imprime la razón en palabras.

¿Debo usar GET o POST?

GET para leer datos, POST para enviarlos, por ejemplo una lectura de sensor a un servicio de registro. HTTPClient tiene http.POST(body), y echo.mokxi responde a un POST con el cuerpo que enviaste, así que puedes probarlo aquí.

¿Por qué http.getString() regresa vacío?

Normalmente porque la solicitud falló y el código fue negativo, o porque el servidor respondió sin cuerpo, como hace un 204. Imprime primero el código de estado; si es 200 y el cuerpo sigue vacío, imprime http.getSize() para ver cuántos bytes dijo el servidor que enviaría.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.