Arduino - Petición HTTP
Arduino puede desempeñar el papel de cliente web para realizar solicitudes HTTP a un servidor web. El servidor web puede ser un sitio web, una API web o una API REST, un servicio web...
En este tutorial, vamos a aprender:
- Conocimientos básicos de cliente web y servidor web
- Cómo realizar una solicitud HTTP (GET y POST)
- Cómo enviar datos a un servidor web (un sitio web, API web o API REST)
- Código de Arduino:
- Realizar una solicitud HTTP GET/POST utilizando Arduino Uno/Mega + Ethernet Shield
- Realizar una solicitud HTTP GET y enviar datos utilizando Arduino Uno/Mega + Ethernet Shield
- Realizar una solicitud HTTP POST y enviar datos utilizando Arduino Uno/Mega + Ethernet Shield
- Arduino Uno R4 WiFi
- Arduino Uno/Mega con Ethernet Shield
- Tu PC/tu teléfono inteligente (como cliente web) realiza una solicitud HTTP a un servidor web
- El servidor web devuelve una respuesta HTTP a tu PC/tu teléfono inteligente
- Tu PC/tu teléfono inteligente recibe la respuesta HTTP y visualiza la respuesta HTTP en tu pantalla
- Cabecera de la solicitud HTTP
- (Opcional) Cuerpo de la solicitud HTTP
- Dirección web (URL)
- Método de solicitud (POST o GET)
- Puerto HTTP que utiliza el servidor web (la mayoría de los servidores web utilizan el puerto 80 para HTTP)
- (Opcional) Datos a enviar al servidor web (cadena de consulta). En este tutorial, suponemos que enviamos temperatura y humedad a un servidor web con el formato ?temperature={t-value}&humidity={h-value}.
- Declare el método de solicitud, el puerto HTTP, nombre de host, ruta, cadena de consulta
- Declara un objeto cliente web
- Conéctese al servidor web
- Si está conectado al servidor, envíe una solicitud HTTP
- Leer los datos de la respuesta del servidor web
- Solicitud HTTP GET
- Solo puede enviar datos en formato de cadena de consulta.
- Los datos se adjuntan a la ruta.
- Solicitud HTTP POST
- Puede enviar datos NO SOLO en formato de cadena de consulta, SINO TAMBIÉN en cualquier otro formato como JSON, XML, imagen ...
- Los datos son el cuerpo de la solicitud HTTP.
- Construir la cadena de consulta
- Modificar el código para enviar datos en la solicitud HTTP
- HTTP GET: agregar cadena de consulta a ruta
- HTTP POST: enviar cadena de consulta como cuerpo HTTP
- Leer los datos de la respuesta del servidor web
- Para el escudo Ethernet, necesitas modificar el código de Arduino. Ver Arduino Ethernet Shield con dirección IP estática
El código para otros escudos o placas WiFi o Ethernet es similar. La diferencia está solo en la biblioteca.
El tutorial proporciona el código de Arduino para dos casos:
Hardware Requerido
| 1 | × | Arduino UNO R4 WiFi | |
| 1 | × | Alternatively, DIYables STEM V4 IoT | |
| 1 | × | Cable USB Tipo-A a Tipo-C (para PC USB-A) | |
| 1 | × | Cable USB Tipo-C a Tipo-C (para PC USB-C) |
Alternatively if using Ethernet:
Or you can buy the following kits:
| 1 | × | DIYables STEM V3 Starter Kit (Arduino included) | |
| 1 | × | DIYables Sensor Kit (30 sensors/displays) | |
| 1 | × | DIYables Sensor Kit (18 sensors/displays) |
Divulgación: Algunos de los enlaces proporcionados en esta sección son enlaces de afiliado de Amazon. Podemos recibir una comisión por las compras realizadas a través de estos enlaces sin costo adicional para usted. Apreciamos su apoyo.
Conocimientos básicos sobre el cliente web y el servidor web
Cuando accedes a un sitio web desde tu PC o teléfono inteligente, solo escribes la dirección web (URL) en un navegador, esperas un segundo y, luego, la página web se muestra en tu PC o teléfono inteligente. No sabes qué hace tu PC o teléfono inteligente detrás de la pantalla. Entonces, ¿qué sucede detrás de la pantalla?
En este tutorial, haremos que Arduino se convierta en un cliente web para hacer algo similar a tu PC o smartphone.
Dirección web (URL)
Una URL incluye dos partes: nombre de host y ruta. El nombre de host puede ser reemplazado por la dirección IP del servidor web. Por ejemplo: example.com/test
En una solicitud HTTP GET, la URL puede incluir la cadena de consulta. Por ejemplo: example.com/test?temperature=20&humidity=70.
Cadena de consulta
La cadena de consulta es un conjunto de pares nombre-valor que se incluyen en una solicitud HTTP para enviar datos desde el cliente web al servidor.
El nombre y el valor están separados por el carácter '='. Los pares nombre-valor están separados por el carácter '&'.
Por ejemplo: temperatura=26&humedad=70&estado=2
Solicitud HTTP
La solicitud HTTP se compone de:
El encabezado de la solicitud HTTP y el cuerpo de la solicitud HTTP están separados por dos pares de caracteres de retorno de carro (ASCII 13, o '\r') y salto de línea (ASCII 10, o '\n').
Hay muchos métodos de solicitud. Entre ellos, hay dos métodos populares: GET y POST.
Normalmente, usamos el método GET cuando queremos obtener datos del servidor web y usamos el método POST para enviar datos al servidor web. Sin embargo, el método GET puede usarse tanto para obtener como para enviar datos desde o hacia el servidor web.
Requisito
Necesitamos determinar los siguientes valores:
La dirección web (URL) se divide en nombre de host y ruta
Cómo hacer una solicitud HTTP
Esta parte presenta solo código relacionado con HTTP. El código completo de cada escudo será presentado en la última parte.
int HTTP_PORT = 80;
String HTTP_METHOD = "GET"; // or "POST"
char HOST_NAME[] = "example.phpoc.com"; // hostname of web server:
String PATH_NAME = "";
| Arduino Ethernet Shield | EthernetClient client; |
| Arduino Uno WiFi | WiFiClient client; |
if(client.connect(HOST_NAME, HTTP_PORT)) {
Serial.println("Connected to server");
} else {
Serial.println("connection failed");
}
// send HTTP request header
client.println(HTTP_METHOD + " " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP request header
while(client.available())
{
// read an incoming byte from the server and print them to serial monitor:
char c = client.read();
Serial.print(c);
}
if(!client.connected())
{
// if the server's disconnected, stop the client:
Serial.println("disconnected");
client.stop();
}
Cómo enviar datos a un servidor web
Podemos incluir datos en la solicitud HTTP. El formato de los datos depende del método de la solicitud HTTP:
Solo necesitamos modificar el código para enviar la solicitud HTTP:
int temp = // read from sensor
int humi = // read from sensor
String queryString = String("?temperature=") + String(temp) + String("&humidity=") + String(humi);
// send HTTP header
client.println("GET " + PATH_NAME + queryString + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
// send HTTP header
client.println("POST " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
// send HTTP body
client.println(queryString);
while(client.available())
{
// read an incoming byte from the server and print them to serial monitor:
char c = client.read();
Serial.print(c);
}
if(!client.connected())
{
// if the server's disconnected, stop the client:
Serial.println("disconnected");
client.stop();
}
Código completo de Arduino para realizar una solicitud HTTP
A continuación se presenta el código completo de Arduino para realizar solicitudes HTTP GET/POST.
Solicitud HTTP GET/POST de Arduino usando Arduino Uno R4 Wifi
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <WiFiS3.h>
const char ssid[] = "YOUR_WIFI_SSID"; // change your network SSID (name)
const char pass[] = "YOUR_WIFI_PASSWORD"; // change your network password (use for WPA, or use as key for WEP)
WiFiClient client;
int status = WL_IDLE_STATUS;
int HTTP_PORT = 80;
String HTTP_METHOD = "GET"; // or POST
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
void setup() {
Serial.begin(9600);
// check for the WiFi module:
if (WiFi.status() == WL_NO_MODULE) {
Serial.println("Communication with WiFi module failed!");
// don't continue
while (true)
;
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION) {
Serial.println("Please upgrade the firmware");
}
// attempt to connect to WiFi network:
while (status != WL_CONNECTED) {
Serial.print("Attempting to connect to SSID: ");
Serial.println(ssid);
// Connect to WPA/WPA2 network. Change this line if using open or WEP network:
status = WiFi.begin(ssid, pass);
// wait 10 seconds for connection:
delay(10000);
}
// print your board's IP address:
Serial.print("IP Address: ");
Serial.println(WiFi.localIP());
// connect to web server on port 80:
if (client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
while (client.connected()) {
if (client.available()) {
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else { // if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
Solicitud HTTP GET/POST de Arduino utilizando el Escudo Ethernet de Arduino
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <SPI.h>
#include <Ethernet.h>
// replace the MAC address below by the MAC address printed on a sticker on the Arduino Shield 2
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EthernetClient client;
int HTTP_PORT = 80;
String HTTP_METHOD = "GET"; // or POST
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
void setup() {
Serial.begin(9600);
// initialize the Ethernet shield using DHCP:
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to obtaining an IP address using DHCP");
while(true);
}
// connect to web server on port 80:
if(client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
while(client.connected()) {
if(client.available()){
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else {// if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
Código completo de Arduino para realizar una solicitud HTTP GET con datos
Petición HTTP GET de Arduino con datos utilizando Arduino Uno R4 Wifi
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <WiFiS3.h>
const char ssid[] = "YOUR_WIFI_SSID"; // change your network SSID (name)
const char pass[] = "YOUR_WIFI_PASSWORD"; // change your network password (use for WPA, or use as key for WEP)
WiFiClient client;
int status = WL_IDLE_STATUS;
int HTTP_PORT = 80;
String HTTP_METHOD = "GET";
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
String queryString = "?value1=26&value2=70";
;
void setup() {
Serial.begin(9600);
// check for the WiFi module:
if (WiFi.status() == WL_NO_MODULE) {
Serial.println("Communication with WiFi module failed!");
// don't continue
while (true)
;
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION) {
Serial.println("Please upgrade the firmware");
}
// attempt to connect to WiFi network:
while (status != WL_CONNECTED) {
Serial.print("Attempting to connect to SSID: ");
Serial.println(ssid);
// Connect to WPA/WPA2 network. Change this line if using open or WEP network:
status = WiFi.begin(ssid, pass);
// wait 10 seconds for connection:
delay(10000);
}
// print your board's IP address:
Serial.print("IP Address: ");
Serial.println(WiFi.localIP());
// connect to web server on port 80:
if (client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + queryString + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
while (client.connected()) {
if (client.available()) {
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else { // if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
Solicitud HTTP GET de Arduino con datos usando Arduino Ethernet Shield
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <SPI.h>
#include <Ethernet.h>
// replace the MAC address below by the MAC address printed on a sticker on the Arduino Shield 2
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EthernetClient client;
int HTTP_PORT = 80;
String HTTP_METHOD = "GET";
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
String queryString = "?value1=26&value2=70";;
void setup() {
Serial.begin(9600);
// initialize the Ethernet shield using DHCP:
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to obtaining an IP address using DHCP");
while(true);
}
// connect to web server on port 80:
if(client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + queryString + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
while(client.connected()) {
if(client.available()){
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else {// if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
Código Arduino completo para realizar una solicitud HTTP POST con datos
Solicitud HTTP POST de Arduino con datos usando Arduino Uno R4 Wifi
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <WiFiS3.h>
const char ssid[] = "YOUR_WIFI_SSID"; // change your network SSID (name)
const char pass[] = "YOUR_WIFI_PASSWORD"; // change your network password (use for WPA, or use as key for WEP)
WiFiClient client;
int status = WL_IDLE_STATUS;
int HTTP_PORT = 80;
String HTTP_METHOD = "POST";
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
String queryString = "?value1=26&value2=70";
;
void setup() {
Serial.begin(9600);
// check for the WiFi module:
if (WiFi.status() == WL_NO_MODULE) {
Serial.println("Communication with WiFi module failed!");
// don't continue
while (true)
;
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION) {
Serial.println("Please upgrade the firmware");
}
// attempt to connect to WiFi network:
while (status != WL_CONNECTED) {
Serial.print("Attempting to connect to SSID: ");
Serial.println(ssid);
// Connect to WPA/WPA2 network. Change this line if using open or WEP network:
status = WiFi.begin(ssid, pass);
// wait 10 seconds for connection:
delay(10000);
}
// print your board's IP address:
Serial.print("IP Address: ");
Serial.println(WiFi.localIP());
// connect to web server on port 80:
if (client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
// send HTTP body
client.println(queryString);
while (client.connected()) {
if (client.available()) {
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else { // if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
Solicitud HTTP POST de Arduino con datos usando Arduino Ethernet Shield
/*
* Este código de Arduino fue desarrollado por es.newbiely.com
* Este código de Arduino se proporciona al público sin ninguna restricción.
* Para tutoriales completos y diagramas de cableado, visite:
* https://es.newbiely.com/tutorials/arduino/arduino-http-request
*/
#include <SPI.h>
#include <Ethernet.h>
// replace the MAC address below by the MAC address printed on a sticker on the Arduino Shield 2
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
EthernetClient client;
int HTTP_PORT = 80;
String HTTP_METHOD = "POST";
char HOST_NAME[] = "maker.ifttt.com";
String PATH_NAME = "/trigger";
String queryString = "?value1=26&value2=70";;
void setup() {
Serial.begin(9600);
// initialize the Ethernet shield using DHCP:
if (Ethernet.begin(mac) == 0) {
Serial.println("Failed to obtaining an IP address using DHCP");
while(true);
}
// connect to web server on port 80:
if(client.connect(HOST_NAME, HTTP_PORT)) {
// if connected:
Serial.println("Connected to server");
// make a HTTP request:
// send HTTP header
client.println(HTTP_METHOD + " " + PATH_NAME + " HTTP/1.1");
client.println("Host: " + String(HOST_NAME));
client.println("Connection: close");
client.println(); // end HTTP header
// send HTTP body
client.println(queryString);
while(client.connected()) {
if(client.available()){
// read an incoming byte from the server and print it to serial monitor:
char c = client.read();
Serial.print(c);
}
}
// the server's disconnected, stop the client:
client.stop();
Serial.println();
Serial.println("disconnected");
} else {// if not connected:
Serial.println("connection failed");
}
}
void loop() {
}
※ Nota:
Este tutorial utilizó la dirección IP dinámica (a través de DHCP). Si quieres usar la dirección IP estática:
WARNING
Tenga en cuenta que este tutorial está incompleto. Publicaremos en nuestra página de Facebook cuando el tutorial esté completo. Déle like para mantenerse actualizado.