O que é API REST e como funciona? Guia completo

O que é API REST e como funciona?

API REST (Representational State Transfer) é um estilo arquitetural para projetar serviços web que permitem a comunicação entre sistemas. Em vez de ser um protocolo ou padrão, a REST define um conjunto de princípios que, quando seguidos, tornam a integração entre aplicações mais flexível, escalável e simples. Ela funciona através de requisições HTTP a recursos identificados por URIs. Cada requisição retorna uma representação do estado atual do recurso (geralmente em JSON ou XML), sem que o servidor precise manter informações sobre requisições anteriores, o que chamamos de stateless.

O que é API REST e para que serve?

API REST serve para integrar sistemas distintos de forma padronizada e leve. Ela permite que um aplicativo, site ou dispositivo consuma dados ou funcionalidades de outro sistema sem precisar conhecer sua implementação interna. Por exemplo, um app de clima usa uma API REST para buscar previsões de um servidor remoto; um site de e-commerce usa para consultar estoque e processar pagamentos. A REST é amplamente adotada por sua simplicidade e compatibilidade com a web.

O que a API REST faz?

A API REST faz a mediação entre cliente e servidor. O cliente (como um navegador ou app mobile) envia uma requisição HTTP para uma URL específica. O servidor processa a requisição, consulta ou altera seus dados, e retorna uma resposta com o resultado. A API REST não armazena dados nem mantém sessão entre requisições; cada chamada é independente e completa. Isso simplifica a escalabilidade: qualquer servidor pode atender qualquer requisição.

O que é uma API padrão REST?

Uma API padrão REST segue as seis restrições arquiteturais definidas por Roy Fielding em 2000: cliente-servidor, stateless, cacheável, interface uniforme, sistema em camadas e código sob demanda (opcional). A interface uniforme é a mais distintiva: recursos são identificados por URIs, a manipulação ocorre via representações (JSON/XML), as mensagens são autodescritivas e hiperlinks guiam a navegação (HATEOAS). Na prática, muitas APIs se chamam REST sem cumprir todos os princípios, sendo na verdade APIs HTTP.

O que é um método REST em uma API?

Métodos REST correspondem aos verbos HTTP que indicam a ação desejada sobre um recurso. Os principais são: GET (ler), POST (criar), PUT (atualizar completamente), PATCH (atualizar parcialmente) e DELETE (remover). Cada método tem comportamento definido e idempotente quando possível. Por exemplo, GET /usuarios retorna a lista de usuários; POST /usuarios cria um novo; DELETE /usuarios/123 remove o usuário de ID 123. A escolha correta do método é essencial para uma API REST consistente.

FAQ

O que significa REST?

REST é a sigla para Representational State Transfer (Transferência de Estado Representacional). O termo foi cunhado por Roy Fielding em sua tese de doutorado de 2000 e descreve como um recurso no servidor tem seu estado transferido ao cliente em formato de representação (JSON, XML).

Qual a diferença entre REST e RESTful?

REST é o estilo arquitetural, o conjunto de princípios. RESTful é o adjetivo usado para descrever uma API que implementa corretamente esses princípios. Dizer "API RESTful" é mais preciso que "API REST", pois indica conformidade com as restrições definidas.

API REST só funciona com JSON?

Não. Embora JSON seja o formato mais comum por ser leve e legível, a REST não exige um formato específico. XML, texto simples, YAML ou até HTML são aceitáveis. A escolha depende da necessidade do sistema e da preferência dos desenvolvedores.

Toda API HTTP é REST?

Não. Muitas APIs HTTP não seguem os princípios REST, como manter estado no servidor ou usar apenas POST para todas as operações. Essas são chamadas de APIs HTTP ou APIs RPC, não REST. Para ser REST, a API precisa ser stateless, ter interface uniforme e usar URIs para identificar recursos.