Apostilas em PDF – API REST

Olá, querida(o) estudante! Hoje vamos explorar um tema essencial no desenvolvimento de sistemas: API REST (Application Programming Interface Representational State Transfer). Presente em quase todas as aplicações modernas, REST é amplamente utilizado para criar interfaces que permitem a comunicação entre sistemas de forma simples, escalável e independente de plataforma. Nesse artigo vamos entender como funcionam as APIs REST e porque elas são uma escolha recorrente para integração de sistemas.

O que é uma API REST?

Uma API REST é uma interface que permite a comunicação entre diferentes sistemas por meio do protocolo HTTP, o mesmo usado para navegar na web. O modelo REST organiza os dados como recursos, que podem ser acessados e manipulados usando métodos padrão, como GET, POST, PUT e DELETE. Essa abordagem promove a simplicidade, já que utiliza mecanismos bem conhecidos do HTTP, e é independente de linguagem ou tecnologia, o que facilita a interoperabilidade.

Exemplo: Imagine que uma API REST de uma livraria online permite acessar informações de livros por meio da URL https://api.livraria.com/livros. Para listar todos os livros, você faria uma requisição GET a essa URL, enquanto para adicionar um novo livro, você usaria uma requisição POST com os dados do livro.

Princípios Fundamentais do REST

Para que uma API seja considerada RESTful, ela precisa seguir alguns princípios fundamentais:

1. Arquitetura Sem Estado (Stateless):
   Cada requisição ao servidor deve conter todas as informações necessárias para processá-la. Isso significa que o servidor não armazena o estado do cliente entre as requisições. Por exemplo, uma requisição POST para criar um novo recurso deve conter todos os dados necessários, sem depender de uma solicitação anterior.
2. Recursos como Elementos Centrais:
   Tudo é tratado como um recurso (como livros, usuários ou pedidos), que pode ser identificado por uma URL única. Os recursos são representados em formatos como JSON ou XML.
3. Interface Uniforme:
   REST utiliza métodos padrão do HTTP com semânticas bem definidas, como:
   • GET: Recuperar dados de um recurso.
   • POST: Criar um novo recurso.
   • PUT: Atualizar um recurso existente.
   • DELETE: Excluir um recurso.

Além disso, é comum termos esses princípios:

4. Cache:
   Respostas das APIs podem ser armazenadas em cache para melhorar o desempenho e reduzir a carga no servidor.
5. Sistemas em Camadas:
   A API REST pode ser projetada em camadas, permitindo a separação de responsabilidades e maior modularidade.

Como o REST se Compara ao SOAP?

Uma dúvida comum em concursos é sobre as diferenças entre REST e SOAP (Simple Object Access Protocol). Enquanto o SOAP é mais rígido e utiliza estritamente mensagens em XML, o REST é mais flexível, permitindo o uso de JSON, XML ou até texto. REST também é mais leve, já que não requer cabeçalhos complexos ou mensagens envolvidas por envelopes XML, como ocorre no SOAP.

Por que escolher REST?

REST é uma escolha comum porque utiliza os recursos existentes do HTTP, como cache, autenticação e cabeçalhos, tornando-o mais simples de implementar e mais leve em termos de consumo de largura de banda. Além disso, sua flexibilidade e suporte a diferentes formatos de dados, como JSON, o tornam ideal para dispositivos móveis e sistemas distribuídos. Já o SOAP é mais robusto em cenários que exigem alta segurança e transações complexas, mas apresenta maior overhead*.

*overhead refere-se aos recursos extras necessários para processar e transmitir dados. No SOAP, isso inclui mensagens envolvidas por envelopes XML, metadados complexos e cabeçalhos adicionais, o que consome mais processamento e largura de banda. No REST, a simplicidade das mensagens em JSON ou texto reduz esse custo, tornando-o mais eficiente.

Métodos HTTP na Prática

Os métodos HTTP são o coração do REST. Vamos entender melhor cada um deles:

• GET: Utilizado para recuperar informações de um recurso sem alterar seu estado.
  • Exemplo: Buscar todos os usuários cadastrados em https://api.exemplo.com/usuarios.
• POST: Usado para criar novos recursos.
  • Exemplo: Adicionar um novo pedido enviando os dados em https://api.exemplo.com/pedidos.
• PUT: Atualiza um recurso existente com novos dados.
  • Exemplo: Alterar as informações de um livro específico.
• PATCH: Atualiza parcialmente um recurso existente. Diferentemente do PUT, o PATCH permite modificar apenas os campos especificados na requisição.
  • Exemplo: Atualizar o preço de um produto sem alterar os demais dados: https://api.exemplo.com/produtos/1.
• DELETE: Remove um recurso.
  • Exemplo: Excluir um usuário de um sistema em https://api.exemplo.com/usuarios/1.
• HEAD: Recupera os metadados de um recurso, como informações de cache ou tamanho do conteúdo, sem retornar o recurso em si.
  • Exemplo: Confirmar se uma página existe antes de baixá-la: https://api.exemplo.com/pagina.

Vantagens do REST

O REST oferece vários benefícios, tornando-o a escolha preferida para muitas APIs modernas:

• Simplicidade: Usa o protocolo HTTP, que é amplamente conhecido e utilizado.
• Escalabilidade: Permite dividir sistemas em componentes independentes e escaláveis.
• Independência de Plataforma: Funciona com qualquer linguagem ou tecnologia que suporte HTTP.
• Eficiência: Requer menos overhead em comparação com SOAP.

Limitações do REST

Apesar de suas vantagens, o REST também possui algumas limitações:

• Segurança: Embora o REST possa usar HTTPS, ele não oferece padrões nativos de segurança, como o SOAP com WS-Security.
• Manutenção de Estado: A natureza stateless do REST pode ser uma limitação em aplicações que exigem persistência de informações entre requisições.

Aplicações Práticas do REST

APIs RESTful são amplamente utilizadas em diferentes cenários:

• E-commerce: Gerenciamento de produtos, carrinhos de compra e pedidos.
• Redes Sociais: APIs para posts, comentários e perfis de usuário.
• Serviços Bancários: Verificação de saldo, transferências e pagamentos.

Exemplo: A API do GitHub permite gerenciar repositórios e contribuições de forma totalmente RESTful.

Conclusão

As APIs REST são indispensáveis no desenvolvimento moderno, oferecendo simplicidade, escalabilidade e eficiência. Sua presença em praticamente todas as áreas, desde e-commerce até redes sociais, reflete sua relevância no mercado. Dominar esses conceitos não só o prepara para concursos, mas também para enfrentar desafios reais no mundo da tecnologia.

Referências

Vamos ver como esse assunto é cobrado em concursos!

1) Ano: 2025 Banca: FGV Órgão: TCE-PI Prova: FGV – 2025 – TCE-PI – Auditor de Controle Externo – Controle Externo – Específica de Tecnologia da Informação – Sistemas, Engenharia de Dados e Ciência de Dados (Manhã)

Um serviço Web foi desenvolvido com a finalidade de disponibilizar dados oriundos de sensores de monitoramento de atividade em uma repartição pública, por meio de requisições HTTP.

A forma de comunicação com o serviço deve ser por meio de uma API REST, em detrimento de uma API SOAP, o que implica a implementação do seguinte requisito: 

• A) armazenar todas as respostas da API em cache.
• B) permitir apenas mensagens XML entre aplicações.
• C) configurar camada adicional de segurança para funcionar com HTTPS.
• D) considerar solicitações anteriores ao processar nova solicitação.
• E) registrar o escopo e a função dos serviços Web em arquivo WSDL.

Gabarito: A

Comentário:

A) Errada. O REST permite cache, mas não é obrigatório armazenar todas as respostas. O uso de cache depende do design e da implementação da API.

B) Errada. O REST não se limita ao XML; ele suporta diversos formatos, como JSON, XML e texto puro. O XML é uma característica do SOAP.

C) Correta. APIs REST não utilizam WS-Security como o SOAP, mas podem garantir segurança por meio de HTTPS, que criptografa as requisições e respostas, protegendo os dados durante a transmissão.

D) Errada. APIs RESTful seguem o princípio de statelessness, ou seja, cada requisição é independente e não considera requisições anteriores.

E) Errada. O arquivo WSDL (Web Services Description Language) é uma característica exclusiva do SOAP e não é utilizado no REST.

2) Ano: 2024 Banca: FUNCERN Órgão: CREA-RN Prova: FUNCERN – 2024 – CREA-RN – Analista de Sistemas

Cada método HTTP possui semântica específica e bem definida, dentro do contexto do modelo de recursos de uma API REST. O objetivo do método HEAD é  

• A) atualizar um recurso.
• B) adicionar um novo recurso.
• C) recuperar os metadados associados ao estado do recurso. 
• D) criar um novo recurso dentro de uma coleção e executar controladores.

Gabarito: C

Comentário: 

A) Errada. O método para atualizar um recurso é o PUT, e não o HEAD.

B) Errada. Adicionar novos recursos é função do POST, e não do HEAD.

C) Correta. O HEAD é usado para obter informações do cabeçalho HTTP de um recurso, como tamanho, tipo de conteúdo e data de última modificação, sem transferir o conteúdo em si.

D) Errada. Criar recursos dentro de coleções é responsabilidade do POST, enquanto o HEAD não realiza alterações ou criação de recursos.

3) Ano: 2024 Banca: FGV Órgão: TJ-RR Prova: FGV – 2024 – TJ-RR – Analista Judiciário – Infraestrutura de Tecnologia da Informação

Uma API REST (Representational State Transfer) é uma interface que permite a comunicação entre sistemas utilizando um determinado protocolo, em que os recursos são acessados e manipulados por meio de requisições padrão como GET, POST, PUT e DELETE, seguindo princípios de simplicidade, escalabilidade e independência de plataforma. 

Isso posto, assinale a afirmativa correta sobre API REST. 

• A) Normalmente, uma solicitação PUT cria um novo registro.
• B) Nenhum dado do cliente é armazenado no servidor entre as solicitações e toda solicitação é separada e desconectada.  
• C) Não há a possibilidade de utilização de cache. 
• D) Utiliza WSDL como linguagem de descrição de serviços web.
• E) É um protocolo com requisitos específicos, como a mensageria XML. 

Gabarito: B

Comentário:

A) Errada. O PUT é usado para atualizar um recurso existente. Ele pode criar um recurso apenas se a URL fornecida não existir, mas isso depende da implementação da API.

B) Correta. O REST segue o princípio de statelessness, no qual nenhuma informação de estado do cliente é armazenada no servidor entre as requisições. Cada requisição é tratada de forma independente.

C) Errada. O REST permite o uso de cache para otimizar o desempenho, mas a decisão de utilizá-lo depende da API.

D) Errada. O WSDL é um padrão utilizado no SOAP para descrever os serviços, e não no REST.

E) Errada. O REST não é um protocolo, mas sim um estilo arquitetural. Além disso, ele não exige XML como padrão de mensageria, sendo mais comum o uso de JSON.

Então é isso! 

Bons estudos e até o nosso próximo artigo.

Prof. Ana Júlia B. de Souza