O que é API REST
API REST (Representational State Transfer) é um estilo arquitetural para construção de APIs web criado por Roy Fielding em 2000 em sua tese de doutorado. Define um conjunto de princípios que tornam APIs simples, escaláveis e compatíveis com a infraestrutura da web — usando métodos HTTP padronizados (GET, POST, PUT, DELETE) sobre recursos identificados por URLs.
Hoje, REST é o padrão dominante em APIs web: Stripe, GitHub, Twitter, Google, Meta e milhões de outras APIs seguem esse estilo. Apesar do surgimento de alternativas como GraphQL e gRPC, REST continua sendo a escolha padrão pela simplicidade, ampla compatibilidade e curva de aprendizado suave.
Os 6 princípios REST
- Cliente-Servidor: Separação clara de responsabilidades
- Stateless: Cada requisição contém toda a informação necessária
- Cacheável: Respostas podem ser armazenadas em cache
- Sistema em Camadas: Cliente não precisa saber se há proxies ou load balancers
- Interface Uniforme: Recursos identificados por URLs, manipulados por métodos HTTP
- Código sob Demanda: (opcional) Servidor pode enviar código executável
Métodos HTTP em REST
- GET: Buscar recurso (idempotente)
- POST: Criar novo recurso
- PUT: Atualizar recurso inteiro (idempotente)
- PATCH: Atualização parcial
- DELETE: Remover recurso
REST combina bem com API Gateway, API Keys para autenticação e Rate Limiting para proteção.
Leia o artigo completo: API REST: princípios, métodos HTTP e boas práticas de design
