Explique o que é REST

REST (Representational State Transfer) é um estilo arquitetural para projetar APIs web. Não é um protocolo nem um padrão formal — é um conjunto de restrições que, quando seguidas, produzem APIs previsíveis, escaláveis e fáceis de consumir.

As restrições principais do REST

1. Cliente-Servidor — a interface do usuário e o armazenamento de dados são separados. Cada lado evolui independentemente.

2. Stateless (sem estado) — cada requisição deve conter todas as informações necessárias para ser processada. O servidor não guarda sessão entre requisições. Estado de autenticação vai no header (ex: Authorization: Bearer <token>).

3. Interface uniforme — recursos são identificados por URIs e manipulados via métodos HTTP padronizados:

   Método	Ação
   GET	Lê um recurso
   POST	Cria um novo recurso
   PUT / PATCH	Atualiza um recurso
   DELETE	Remove um recurso

4. Recursos como substantivos — a URI identifica o quê, o método HTTP diz o que fazer:

   • GET /users — lista usuários
   • POST /users — cria um usuário
   • GET /users/42 — busca o usuário 42
   • DELETE /users/42 — remove o usuário 42

5. Representações — o servidor retorna uma representação do recurso (geralmente JSON), não o recurso em si.

6. Cacheável — respostas devem indicar se podem ser cacheadas, permitindo que clientes e intermediários (proxies, CDNs) reutilizem respostas.

REST vs REST "de fato"

Na prática, a maioria das APIs chamadas "REST" são na verdade RESTful no sentido informal — usam HTTP + JSON com URIs razoáveis, mas não seguem todas as restrições (ex: HATEOAS). Isso é aceitável na maioria dos contextos.

O que REST não é:

• Não é um protocolo (o protocolo é HTTP)
• Não é só "usar JSON"
• Não é SOAP (que é um protocolo com contrato XML formal)