Uma API REST (também conhecida como API RESTful) é uma interface de programação de aplicativos (API ou API Web) que está em conformidade com as restrições do estilo de arquitetura REST e permite a interação com serviços Web RESTful. REST significa Representational State Transfer e foi criado pelo cientista da computação Roy Fielding.
O que é uma API
Uma API é um conjunto de definições e protocolos para criar e integrar software de aplicativo. Às vezes é conhecido como um contrato entre um provedor de informações e um usuário de informações, que estabelece o conteúdo exigido pelo consumidor (a chamada) e o conteúdo exigido pelo produtor (a resposta). Por exemplo, o design da API para um serviço meteorológico pode especificar que o usuário forneça um código postal e o produtor responda com uma resposta em duas partes, sendo a primeira temperatura alta e a segunda temperatura baixa.
Em outras palavras, se você deseja interagir com um computador ou sistema para recuperar informações ou executar uma função, uma API o ajuda a comunicar o que deseja a esse sistema para que ele possa entender e atender à solicitação.
Você pode pensar em uma API como um mediador entre usuários ou clientes e os recursos ou serviços da Web que eles desejam obter. É também uma maneira de uma organização compartilhar recursos e informações enquanto mantém a segurança, o controle e a autenticação, o que determina quem tem acesso a quê.
Outra vantagem de uma API é que você não precisa conhecer os detalhes do cache: como seu recurso é recuperado ou de onde ele veio.
O que é RESTO
REST é um conjunto de restrições arquitetônicas, não um protocolo ou padrão. Os desenvolvedores de API podem implementar REST de várias maneiras.
Quando uma solicitação de cliente é feita por meio de uma API RESTful, ela passa uma representação do estado do recurso para o solicitante ou endpoint. Essa informação, ou representação, é fornecida em um dos vários formatos por HTTP: JSON (Javascript Object Notation), HTML, XLT, Python, PHP ou texto simples. JSON é o formato de arquivo mais popular em geral porque, apesar do nome, é independente da linguagem e pode ser lido por humanos e máquinas.
Outra coisa a ser observada: cabeçalhos e parâmetros também são importantes nos métodos HTTP de uma solicitação HTTP da API RESTful, pois contêm informações de identificação importantes em termos de metadados de solicitação, autorização, identificador uniforme (URI), cache, cookies e muito mais. Existem cabeçalhos de solicitação e cabeçalhos de resposta, cada um com suas próprias informações de conexão HTTP e códigos de status.
Para que uma API seja considerada RESTful, ela deve atender a estes critérios:
- Uma arquitetura cliente-servidor composta de clientes, servidores e recursos, com solicitações tratadas por HTTP.
- Comunicação cliente-servidor sem estado, o que significa que nenhuma informação do cliente é armazenada entre solicitações de obtenção e cada solicitação é independente e não conectada.
- Cache de dados que simplifica as interações cliente-servidor.
- Uma interface uniforme entre os componentes para que as informações sejam transferidas de maneira padronizada. Isso requer que:
- os recursos solicitados são identificáveis e separados das representações enviadas ao cliente.
- Os recursos podem ser manipulados pelo cliente por meio da representação que recebem, pois a representação contém informações suficientes para isso.
- mensagens autodescritivas retornadas ao cliente têm informações suficientes para descrever como o cliente deve processá-las.
- hipertexto/hipermídia está disponível, o que significa que depois de acessar um recurso, o cliente deve poder usar hiperlinks para encontrar todas as outras ações atualmente disponíveis que ele pode executar.
- Um sistema em camadas que organiza cada tipo de servidor (responsáveis pela segurança, balanceamento de carga, etc.) implica a recuperação das informações solicitadas em hierarquias, invisíveis ao cliente.
- Code on Demand (opcional): A capacidade de enviar código executável do servidor para o cliente quando solicitado, estendendo a funcionalidade do cliente.
Embora a API REST tenha esses critérios para atender, ela ainda é considerada mais fácil de usar do que um protocolo prescrito como SOAP (Simple Object Access Protocol), que possui requisitos específicos como mensagens XML e segurança integrada e conformidade de transações que facilitam a uso. lento e mais pesado.
Por outro lado, REST é um conjunto de diretrizes que podem ser implementadas conforme necessário, tornando as APIs REST mais rápidas e leves, com maior escalabilidade, perfeitas para Internet das Coisas (IoT) e desenvolvimento de software.
