O que é REST?

REST (Representational State Transfer) é um estilo arquitetural usado para criar APIs (Application Programming Interfaces) que utilizam o protocolo HTTP. Ele define um conjunto de princípios que regem a comunicação entre clientes e servidores na web. O conceito central do REST é a ideia de “recursos” identificados por URLs (Uniform Resource Locators). Esses recursos podem ser manipulados por meio de operações HTTP como:

• GET (para recuperar informações),
• POST (para criar recursos),
• PUT (para atualizar),
• DELETE (para remover).

Um serviço RESTful usa essas operações de forma intuitiva, permitindo a interação com recursos pela web de maneira eficiente e escalável.

API vs Web Services

• API: Uma API é uma interface que permite a comunicação entre diferentes sistemas. APIs podem ser implementadas de várias maneiras, como por meio de chamadas locais, de rede ou até por eventos. As APIs expõem funcionalidades que outros softwares podem usar para integração.
• Web Services: Um web service é um tipo de API, mas especificamente voltado para comunicação na web, geralmente usando XML ou JSON como formatos de dados. Web services são um subconjunto de APIs e são usados principalmente para permitir a interação entre aplicações via internet.

Diferença principal: Toda Web Service é uma API, mas nem toda API é um Web Service. Web Services geralmente seguem padrões como SOAP ou REST, enquanto APIs podem ter diversas formas de implementação (REST, SOAP, GraphQL, etc.).

REST vs RESTful

• REST: Refere-se ao conjunto de princípios arquiteturais. Ele define como os recursos da web devem ser acessados e manipulados.
• RESTful: Quando um serviço segue as restrições do estilo REST, ele é chamado de RESTful. Um serviço RESTful é, portanto, uma implementação de uma API que adota os princípios do REST.

Princípios REST:

• Client-Server: Separação entre o cliente e o servidor.
• Stateless: Cada requisição do cliente para o servidor deve conter todas as informações necessárias para ser entendida e processada.
• Cacheable: As respostas devem indicar se são cacheáveis para melhorar o desempenho.
• Uniform Interface: Uso de uma interface padronizada e bem definida, normalmente usando métodos HTTP.
• Layered System: O sistema pode ser composto de várias camadas, sem que o cliente precise saber sobre as camadas intermediárias.

Como uma API RESTful Funciona

Uma API RESTful funciona interagindo com recursos através de chamadas HTTP, que seguem o protocolo padrão da web. Cada recurso é representado por uma URL única, e as operações realizadas sobre eles são baseadas em métodos HTTP.

Exemplo básico de uma interação com uma API RESTful:

1. GET /usuarios/123 – Recupera as informações do usuário com ID 123.
2. POST /usuarios – Cria um novo usuário enviando os dados no corpo da requisição.
3. PUT /usuarios/123 – Atualiza os dados do usuário com ID 123.
4. DELETE /usuarios/123 – Remove o usuário com ID 123.

As APIs RESTful geralmente usam o formato de dados JSON (JavaScript Object Notation) por ser leve e amplamente aceito, mas também podem usar XML.

Diferenças Principais entre REST e Outros Web Services (SOAP)

• REST: Simples, usa operações HTTP diretamente, sendo mais leve, escalável e frequentemente baseado em JSON.
• SOAP: Protocolo mais complexo, baseado em XML, com padrões mais rígidos, sendo comum em ambientes corporativos onde transações seguras e complexas são necessárias.

Assim, REST é amplamente usado em APIs modernas pela sua simplicidade, enquanto SOAP é mais voltado para ambientes de integração robustos com segurança e transações.

API RESTful – Guia definitivo com Spring Boot e Java 8