O que é uma API REST e o que significam GET, POST, PUT e DELETE?
Publicado em 2026-10-20 por frfrand
API REST explicada con ejemplos de clientes y productos: recursos, métodos HTTP, códigos de estado y diferencias con una API cualquiera.
Uma API REST é uma interface projetada seguindo um estilo de arquitetura centrado em recursos e no uso coerente de mecanismos do protocolo web. Muitas APIs que chamamos de REST se comunicam via HTTP e usam métodos como GET, POST, PUT, PATCH e DELETE.
Mas REST não é simplesmente «enviar JSON via HTTP». O design de recursos, as representações e a semântica das operações também importam.
O exemplo de uma loja online
Imagine que você tem produtos e pedidos. Um aplicativo móvel e um site precisam consultar ambos os tipos de informação.
Em vez de inventar uma ordem textual diferente para cada tarefa, você pode utilizar rotas reconhecíveis: /produtos, /produtos/42 ou /pedidos/15.
A rota identifica um recurso ou uma coleção. O método HTTP indica que tipo de operação o cliente solicita.
O que faz o GET?
GET /produtos/42 geralmente solicita uma representação do produto identificado como 42.
Por design, o GET deve ser usado para operações de leitura e não deve provocar efeitos de negócio perigosos, como cobrar uma compra ou excluir uma conta.
Isso não impede que o servidor registre métricas ou acessos, mas a operação exposta ao cliente deve respeitar as expectativas do protocolo.
Para que servem POST, PUT, PATCH e DELETE?
POST geralmente é usado para enviar informações que o servidor processará, como criar um pedido.
PUT é usado habitualmente para criar ou substituir a representação de um recurso identificado.
PATCH permite aplicar modificações parciais de acordo com o formato de requisição definido.
DELETE solicita a exclusão de um recurso ou a operação de exclusão correspondente.
Não é correto afirmar que todos os backends devem atribuir exatamente CRUD a esses métodos sem considerar o design e a semântica real.
O que é um código de status HTTP?
O servidor devolve um código que ajuda a entender o resultado da requisição.
Por exemplo, 200 OK indica sucesso em um caso habitual, 201 Created pode indicar criação, 400 Bad Request uma requisição inválida, 401 Unauthorized falta de autenticação adequada, 403 Forbidden um acesso rejeitado e 404 Not Found um recurso não encontrado.
O código não substitui uma explicação útil do erro, mas permite que clientes e ferramentas reajam corretamente.
Qual formato uma API REST utiliza?
Muitas utilizam JSON porque é conveniente para trocar dados estruturados. Mas o REST não exige necessariamente JSON. Podem existir outras representações de acordo com a aplicação.
Também não exige que o frontend esteja feito em uma linguagem específica. Um backend Django pode oferecer uma API consumida desde React, um app Android e outros serviços.
Por que se fala de stateless?
No estilo REST, as requisições deveriam conter informação suficiente para que o servidor as interprete, sem depender de uma conversa implícita que só se conhece por ter recebido requisições anteriores.
Isso não significa que o sistema não possa guardar pedidos, usuários ou sessões em bancos de dados. Significa que o contrato das solicitações deve permitir entender o que cada operação requer.
Como proteger uma API?
Precisa de autenticação quando for o caso, autorização por recurso, validação de dados, limites de abuso e tratamento correto de erros.
Esconder um botão no frontend não impede que alguém chame diretamente o endpoint. Por exemplo, GET /pedidos/15 não deveria revelar informações apenas porque alguém adivinhou o número do pedido.
Também convém aplicar consultas parametrizadas e revisar quais dados são devolvidos para não expor campos internos.
E se precisar atualizar informações em tempo real?
Você pode complementar uma API HTTP com webhooks, WebSocket ou outras tecnologias. Não é preciso forçar todos os cenários ao mesmo padrão se uma alternativa for mais adequada.
Um aplicativo pode consultar produtos por REST e receber notificações por um canal diferente.
Como se relaciona com o ArduMaker?
Os backends implantados dentro de VPS do ArduMaker podem oferecer APIs HTTP para se conectar com outros programas. A plataforma fornece a infraestrutura e ferramentas de integração; o contrato de recursos, métodos e permissões pertence ao design do software.
Em resumo: REST é uma forma de organizar interfaces web em torno de recursos e regras coerentes. Aprender os métodos e códigos HTTP permite entender boa parte das APIs modernas.
Fontes: Métodos HTTP em MDN · Visão geral do HTTP · O que é uma API.