Conecte aplicações
API REST, HTTP e JSON
Entenda como cliente e servidor trocam requisições, respostas e dados.
Objetivo
Identificar método, rota, status e corpo JSON em uma comunicação HTTP.
Pré-requisito
Noções de aplicação e dados estruturados.
O que é
Conceito sem complicação
Uma API REST expõe recursos por URLs e usa métodos HTTP para consultar ou alterar dados. JSON é um formato textual comum nessa troca.
Aplicativos mobile, sites e integrações dependem de APIs para compartilhar dados e regras.
O cliente faz um pedido ao balcão; o servidor processa e devolve uma resposta com status e conteúdo.
requisicao.http
http
GET /api/produtos/42 HTTP/1.1
Host: exemplo.com
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 42,
"nome": "Teclado",
"estoque": 10
}Linha por linha
GET indica uma leitura de recurso.
/api/produtos/42 identifica o recurso solicitado.
200 OK informa que a operação foi bem-sucedida.
Content-Type descreve o formato da resposta.
O JSON transporta campos e valores estruturados.
Erro comum
Tratar todo erro como status 200 e esconder a falha apenas dentro do JSON.
Exercício guiado
Escreva uma requisição GET para listar todos os clientes.
Agora sozinho
Desenhe uma API de tarefas com rotas para listar, criar e concluir uma tarefa.
Preciso de uma dica
Use GET para consultar, POST para criar e PATCH para alterar parcialmente.
Teste seu conhecimento
Qual status normalmente representa recurso não encontrado?
Progresso da aula