Arduino Nano - Requisição HTTP - Cliente Web
O Arduino Nano pode atuar como um cliente web, enviando requisições HTTP a um servidor web. Esse servidor web pode ser um site, uma Web API, uma REST API ou um serviço Web...
Este tutorial ensina como usar o Arduino Nano para fazer uma Requisição HTTP a um servidor web. Em detalhes, vamos aprender:
- Os fundamentos de cliente web e servidor web
- Como criar uma requisição HTTP (GET e POST)
- Como enviar dados a um servidor web (um site, WEB API ou REST API)
- Código do Arduino Nano:
- Fazendo requisições HTTP GET/POST usando o Arduino Nano e o módulo Ethernet
- Fazendo requisição HTTP GET e enviando dados usando o Arduino Nano e o módulo Ethernet
- Fazendo requisição HTTP POST e enviando dados usando o Arduino Nano e o módulo Ethernet
- Crie um objeto de cliente web.
- Estabeleça uma conexão com o servidor web.
- Se estiver conectado ao servidor, envie uma requisição HTTP.
- Recupere os dados de resposta do servidor web.
- Requisição HTTP GET:
- Os dados só podem ser enviados na query string.
- Os dados são anexados à URL.
- Requisição HTTP POST:
- Os dados podem ser enviados em vários formatos, como query string, JSON, XML, imagens etc.
- Os dados são colocados no corpo da requisição HTTP.
- Construir a query string (se necessário).
- Montar a requisição HTTP.
- Enviar a requisição.
- Construa a query string
- Monte o código para enviar Dados na requisição HTTP
- HTTP GET: adicione uma query string ao caminho
- HTTP POST: transmita a query string no corpo HTTP
- Recupere os dados de resposta do servidor web.
- Conecte o Arduino Nano ao módulo Ethernet de acordo com o diagrama de ligação acima.
- Conecte um cabo Ethernet ao módulo Ethernet.
- Conecte o Arduino Nano a um PC usando um cabo USB.
- Abra a Arduino IDE no seu PC.
- Selecione a placa Arduino Nano e a porta COM correspondente
- Clique no ícone Libraries na barra à esquerda da Arduino IDE.
- Pesquise “Ethernet”, depois encontre a biblioteca Ethernet de Various
- Clique no botão Install para instalar a biblioteca Ethernet.
- Copie o código acima e abra com a Arduino IDE
- Clique no botão Upload na Arduino IDE para fazer upload do código para o Arduino Nano
- Abra o Serial Monitor
- Confira o resultado no Serial Monitor.
Hardware Necessário
Or you can buy the following kits:
| 1 | × | DIYables Sensor Kit (18 sensors/displays) |
Divulgação: Alguns dos links desta seção são links de afiliado da Amazon. Podemos receber uma comissão pelas compras feitas por meio desses links, sem custo adicional para você. Agradecemos o seu apoio.
Conceitos Básicos de Cliente Web e Servidor Web
Alguns conceitos web importantes incluem endereço web (URL), nome do host, caminho, query string e requisição HTTP. Você pode aprender mais sobre eles em detalhes no tutorial de HTTP.
Diagrama de Ligação entre o Arduino Nano e o módulo Ethernet W5500
This image is created using Fritzing. Click to enlarge image
Veja A melhor forma de alimentar o Arduino Nano e outros componentes.
image source: diyables.io
Como Fazer uma Requisição HTTP usando Arduino e o módulo Ethernet
Declare o método da requisição, a porta para HTTP, o nome do host, o caminho, a query string e os cabeçalhos relacionados ao código.
int HTTP_PORT = 80;
String HTTP_METHOD = "GET"; // or "POST"
char HOST_NAME[] = "example.newbiely.com"; // hostname of web server:
String PATH_NAME = "";
EthernetClient 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();
}
Como Enviar Dados a um Servidor Web
Podemos incluir dados em uma requisição HTTP, e o formato depende do método da requisição HTTP:
Passos para enviar uma requisição HTTP:
Por exemplo:
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); // or JSON, XML, CSV ...
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 Arduino Nano - Fazendo Requisição HTTP
Este é o código completo do Arduino Nano para fazer requisições HTTP GET e POST.
/*
* Este código de Arduino Nano foi desenvolvido por pt.newbiely.com
* Este código de Arduino Nano é disponibilizado ao público sem nenhuma restrição.
* Para tutoriais completos e diagramas de ligação, visite:
* https://pt.newbiely.com/tutorials/arduino-nano/arduino-nano-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() {
}
Passos Rápidos
Observe que o código acima demonstra como fazer uma requisição HTTP. Você precisa substituir URL e queryString pelos seus próprios valores para que funcione.
Código Arduino Nano - Fazendo Requisição HTTP GET com dados
/*
* Este código de Arduino Nano foi desenvolvido por pt.newbiely.com
* Este código de Arduino Nano é disponibilizado ao público sem nenhuma restrição.
* Para tutoriais completos e diagramas de ligação, visite:
* https://pt.newbiely.com/tutorials/arduino-nano/arduino-nano-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 Nano - Fazendo Requisição HTTP POST com dados
/*
* Este código de Arduino Nano foi desenvolvido por pt.newbiely.com
* Este código de Arduino Nano é disponibilizado ao público sem nenhuma restrição.
* Para tutoriais completos e diagramas de ligação, visite:
* https://pt.newbiely.com/tutorials/arduino-nano/arduino-nano-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); // or JSON, XML, CSV data
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() {
}