Quando abrimos um navegador, digitamos uma URL na barra de endereço e damos um ENTER, o navegador (O CLIENTE) faz uma requisição para um recurso hospedado em um servidor. O SERVIDOR então devolve para o cliente o recurso requisitado (páginas html, scripts PHP, ASP, JSP, arquivos css, arquivos js, imagens, e documentos de diversas espécies, .DOC.XLS,PDF, XML, JSON,entre outros).
Essa resposta é uma espécie de pacote composto por dados e por um código de STATUS. Esse código serve para indicar para o cliente, a situação da resposta dada pelo servidor. Se o recurso requisitado foi enviado com sucesso ou não, seja por não ter encontrado o recurso requisitado, seja por conta de alguma problema que o servidor requisitado tenha enfrentado. Toda essa troca de informação é feita por meio do protocolo HTTP.
HTTP é um protocolo (protocol) que permite a obtenção de recursos, como documentos HTML. É a base de qualquer troca de dados na Web e um protocolo cliente-servidor, o que significa que as requisições são iniciadas pelo destinatário, geralmente um navegador da Web. Um documento completo é reconstruído a partir dos diferentes sub-documentos obtidos, como por exemplo texto, descrição do layout, imagens, vídeos, scripts e muito mais.
Os códigos de status do HTTP são representados por 5 grupos de numeração. São eles
- 100 a 199 - status de informação
- 200 a 299 - status de sucesso (200 OK)
- 300 a 399 - status de redirecionamento
- 400 a 499 - status de erro de cliente (404 página não encontrada)
- 500 a 599 - status de erro de servidor (500 erro no servidor)
Algo muito comum hoje em dia é a requisição a uma API (application programing Interface). Trata-se de um recurso que pode ter diversas funcionalidades que são retornadas em formato XML ou formato JSON. Para requisitar esses recursos, é necessário conhecer o endereço que é a URL(Uniforme Resource Locator) desse recurso.
Esse endereço é composto pelo tipo de protocolo(http://), mais o IP do servidor (127.0.0.1) e a porta que está sendo utilizada (:5094).
É importante também se conhecer o nome do recurso que é chamado de URN (Uniforme Resource Name).
A junção da URL com a URN é conhecida com URI (Universal Resource Identifier).
Exemplo: http://127.0.0.1:3000/clientes
Sabendo disso, nos resta fazer as requisições de forma padronizada e é aí que entra o conceito de REST (Representational State Transfer).
A requisição é feita por meio de métodos do protocolo HTTP. São eles:
- GET (quando se quer buscar alguma informação)
- POST (quando se quer registrar alguma informação no servidor)
- PUT (quando se quer alterar alguma informação registrada no servidor)
- DELETE (quando se quer excluir alguma informação registrada no servidor)
Bom, vamos parar de papo furado e colocar a mão na massa. Para isso, vamos fazer uso do CURL.
O que é o curl
Curl é uma ferramenta para transferir dados de/para um servidor, usando um dos protocolos suportados. Normalmente estamos usando o HTTP.
Ele é uma ferramenta de linha de comando que funciona como interface para a biblioteca que faz o serviço pesado, o libcurl.
De forma geral, seu navegador realiza requisições web, recebe respostas, lê/escreve cookies e renderiza sua página. O curl pode fazer tudo isso, exceto a renderização, que cabe ao seu navegador.
Ele oferece uma infinidade de funções úteis como realização de autenticação, interação com API's, preencher formulários HTML, download de arquivos e paginas HTML etc.
Desde de a versão 10 o CURL já vem instalado no windows.
Abra o prompt do windows e digite curl www.google.com/
A resposta será o código HTML da página inicial do google.
Também é possível obter uma resposta mais verbosa, permitindo visualizar os cabeçalhos da requisição HTTP usando a opção -i. Executando o comando abaixo você poderá vizualizar informações como o Status Code da resposta, a data e hora em que ela foi enviada, o tipo do conteúdo da resposta e várias outras informações que podem variar a depender da implementação do servidor.
curl -i http://www.google.com/
A primeira linha indica a versão do protocolo HTTP usada e o Status Code de sucesso (200).
Caso queira ignorar o conteúdo da página e receber somente o cabeçalho, você pode usar a opção -I (i maiúsculo).
curl -I https://www.google.com/
Fazendo download de arquivos:
Vamos utilizar aqui a mídia de instalação da ultima versão do Ubuntu como exemplo. Para fazer o download de um arquivo, salvando com o mesmo nome do arquivo definido pelo servidor, basta usar a opção -O.
curl-O https://releases.ubuntu.com/20.04.1/ubuntu-20.04.1-desktop-amd64.iso
Interagindo com API's REST com GET e POST
Ela possui as seguintes rotas:
GET /posts
GET /posts/:id
GET /posts/:id/comments
GET /comments?postId={:id}
POST /posts
PUT /posts/:id
PATCH /posts/:id
DELETE /posts/:id
Por padrão, o curl usa o método HTTP GET para realizar as requisições. Para fazer uma requisição GET, basta executar
curl https://jsonplaceholder.typicode.com/posts
O retorno será em formato JSON contendo uma lista de posts:
[
{
"userId": 1,
"id": 1,
"title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
"body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum
rerum est autem sunt rem eveniet architecto"
},
{
"userId": 1,
"id": 2,
"title": "qui est esse",
"body": "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate
porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla"
},
{
"userId": 1,
"id": 3,
"title": "ea molestias quasi exercitationem repellat qui ipsa sit aut",
"body": "et iusto sed quo iure\nvoluptatem occaecati omnis eligendi aut ad\nvoluptatem doloribus vel accusantium quis
pariatur\nmolestiae porro eius odio et labore et velit aut"
},
[continua ...]
Também é possível especificar qual método usar, passando a opção -X e o método como argumento:
curl -X GET https://jsonplaceholder.typicode.com/posts
Para realizar a criação de um post, você pode executar:
curl -i -X POST https:
"postId": 101,
"name": "Vitor Almeida",
"email": "vitor.almeida@alura.com.br",
"body": "De acordo ao manual do curl ( disponível online [...]"
}'
Resultando em
HTTP/2 201
date: Tue, 05 Jan 2021 01:17:53 GMT
content-type: application/json; charset=utf-8
content-length: 168
set-cookie: __cfduid=d4f15935c351e1b9ece6e8d8cdb1ffa1a1609809470; expires=Thu, 04-Feb-21 01:17:50 GMT;
path=/; domain=.typicode.com; HttpOnly; SameSite=Lax
x-powered-by: Express
[continua ...]
{
"postId": 101,
"name": "Vitor Almeida",
"email": "vitor.almeida@alura.com.br",
"body": "De acordo ao manual do curl ( disponível online [...]",
"id": 501
}
A opção -H permite adicionar um cabeçalho e a -d permite passar os dados da requisição. Nesse caso, definimos que o conteúdo é no formato JSON e passamos o conteúdo da requisição que será usado para criar uma conta. Podemos ver no resultado que o status foi 201, indicando que um novo recurso foi criado.
Uma alternativa ao CURL é um cara chamado POSTMAN, mas uma coisa de cada vez. Um dia faço um POST sobre o assunto.
Até a próxima!
