Definição
Representational State Transfer: estilo de arquitetura descrito por Roy Fielding em 2000, em que recursos identificados por URIs são manipulados por uma interface uniforme, em geral os métodos do HTTP.
Como funciona
As restrições do REST incluem cliente-servidor, comunicação sem estado (cada requisição traz tudo o que é preciso para ser entendida), respostas que podem ir para cache, interface uniforme e sistema em camadas.
Numa API REST sobre HTTP, cada recurso tem uma URI (/ramais/2001), e os métodos expressam a ação: GET lê, POST cria, PUT substitui, PATCH altera em parte e DELETE remove. Os códigos de status (200, 201, 404, 409 e outros) dizem o resultado.
Muita API chamada de REST é, na prática, HTTP com JSON sem seguir todas as restrições. O termo virou sinônimo de “API web por recursos”.
Na prática
Requisição fictícia que ativa o siga-me de um ramal:
PATCH /v1/ramais/2001 HTTP/1.1
Host: api.example.com
Authorization: Bearer <token>
Content-Type: application/json
{"siga_me": "2002"}Erro comum
Usar GET para ações que mudam estado. O GET deve ser seguro e idempotente; caches, pré-carregamento de navegadores e robôs podem repetir GETs à vontade, disparando a ação várias vezes.
Termos relacionados
Referências
Padrões e documentação
- Roy T. Fielding (2000): Architectural Styles and the Design of Network-based Software Architectures
- RFC 9110: HTTP Semantics
- RFC 5789: PATCH Method for HTTP
Veja também o glossário completo, o blog e os cursos da EDCA.