API REST
Estilo de arquitetura de API que usa os métodos e códigos do próprio HTTP para operar sobre recursos identificados por URL, sem guardar estado entre chamadas.
Também conhecido como: api rest · api restful · rest api · restful · arquitetura rest
Testar o CRPRO grátis por 7 diasREST (Representational State Transfer) é um estilo de arquitetura para APIs. Uma API que segue esse estilo é chamada de RESTful. A ideia central: tudo é um recurso com endereço próprio, manipulado pelos verbos que o HTTP já oferece.
Os métodos
| Método | O que faz |
|---|---|
| GET | busca dados, sem alterar nada |
| POST | cria um recurso novo |
| PUT / PATCH | atualiza um recurso existente (todo / em parte) |
| DELETE | remove |
Assim, GET /contatos/42 busca o contato 42 e DELETE /contatos/42 o remove. O endereço diz o quê; o método diz a ação.
Os códigos de status que você vai encontrar
- 2xx — deu certo (200 ok, 201 criado).
- 4xx — o erro foi de quem pediu: 401 sem credencial, 403 sem permissão, 404 não existe, 429 excedeu o rate limit.
- 5xx — o erro foi do servidor. Aqui repetir a chamada costuma fazer sentido; em 4xx, não.
Sem estado — e por que isso importa
REST é stateless: cada chamada carrega tudo que precisa e o servidor não guarda memória entre uma e outra. Isso simplifica escala, mas significa que a autenticação vai em toda requisição.
REST, SOAP e GraphQL
- SOAP — mais antigo, baseado em XML, mais rígido e verboso. Ainda comum em bancos e sistemas legados.
- GraphQL — o cliente descreve exatamente os campos que quer, numa chamada só. Evita trazer dados demais.
- REST — o padrão dominante em integrações web, inclusive na API do WhatsApp.
Perguntas frequentes
Qual a diferença entre API e API REST?
API é o conceito geral de interface entre sistemas. REST é um estilo de arquitetura específico, que usa os métodos e códigos do HTTP e trata cada dado como um recurso com endereço próprio.
O que significa RESTful?
É o adjetivo para uma API que segue os princípios REST: recursos identificados por URL, verbos HTTP para as ações e comunicação sem estado entre chamadas.
O que significa o erro 429?
Too Many Requests: você excedeu o limite de chamadas permitido no período. A solução é reduzir a frequência e respeitar o intervalo indicado na resposta, não repetir imediatamente.
Quando usar GraphQL em vez de REST?
Quando o cliente precisa de combinações variáveis de campos e o excesso de dados trafegados vira problema. Para integrações simples e previsíveis, REST costuma ser mais direto de operar.
Páginas relacionadas
Termos relacionados no glossário
API
Interface que permite a dois sistemas trocarem dados e comandos entre si, sem que um precise conhecer o funcionamento interno do outro.
Recebimento automático (WhatsApp Business)
Webhook do WhatsApp é o endereço HTTPS que recebe da Meta, em tempo real, os eventos do número: mensagem nova, status de entrega, template e alertas.
conexão em nuvem do WhatsApp
A Cloud API do WhatsApp (conexão em nuvem) é a versão da API oficial hospedada pela própria Meta, sem servidor próprio da empresa.
Latência
Tempo decorrido entre enviar uma requisição e receber o começo da resposta, medido em milissegundos e percebido pelo usuário como demora.