O que é uma API REST? Diz algo para parar ou pausar? Uma API RESTful é um programa lento ou que inicia um estado de repouso? Se você está interessado na Web e em como as várias tecnologias por trás dela funcionam, convém saber sobre a API RESTful.
Uma API é uma interface de programação de aplicativos. Uma API pode ser muitas coisas para muitos programadores, mas essencialmente é um intermediário que permite conectar um programa a outro. Muitos programadores e desenvolvedores ocultam seu código principal para impedir que outros roubem todo o seu trabalho duro. Se eles desejam que outros programas funcionem com eles, também precisam disponibilizar algum código para permitir essa interação. É aí que as APIs entram. Um desenvolvedor pode criar APIs que permitem a outros programas interagir com sua criação e fornecer recursos e interações extras.
Uma API será gravada com uma certa estrutura formatada de uma certa maneira que o recurso possa entender e que não use muitos recursos. Muitos sites, programas e plataformas usam APIs. O Facebook os possui, o YouTube os utiliza, o Google Maps os possui, o Android e o iOS os utilizam, e o software mais notável terá algum tipo de interface de programação. É uma boa maneira de agregar valor e recursos sem mostrar ao mundo como o seu programa é organizado.
Como as APIs são usadas?
Por exemplo, digamos que você queira criar um conjunto de filtros de câmera para um telefone. Em vez de criar seu próprio aplicativo de câmera, você usaria a API de câmera da Apple ou Android para utilizá-la. A alternativa seria criar um software de câmera totalmente novo para cada sistema operacional do telefone, o que dá muito trabalho. Em vez disso, você só precisa criar uma API que possa se comunicar com o software da câmera existente e enviar os dados do filtro para e a partir dele.
As APIs também podem ser usadas para acessar recursos do sistema, interagir com outros sistemas, fornecer recursos de valor agregado aos navegadores e todas essas coisas boas. Se você se lembrar que uma API é um pedaço de código que fala com outros programas, você deve ficar bem.
Outro exemplo seria o Google Maps. Se você deseja adicionar um mapa do Google ao seu site mostrando sua localização, configure uma API do Google Maps com uma consulta HTTP GET para obter o mapa do Google. Dessa forma, você obtém o que deseja sem que o Google precise fazer nada ou permitir o acesso às partes internas de sua plataforma de mapeamento.
Ao usar uma API, os servidores do Google Maps podem atender a milhões de consultas em um curto período de tempo sem sobrecarregar o servidor de mapas. As consultas da API serão estruturadas corretamente para poderem ser satisfeitas usando o menor número de recursos. A API RESTful garante que nada possa ser gravado no banco de dados e não deixa rastreio, deixando o servidor de mapa passar para a próxima consulta.
API RESTful
REST significa REpresentational State Transfer. Uma API RESTful é usada para transferir dados de um recurso para um cliente. Como exemplo, um mecanismo de pesquisa usa um tipo de API RESTful. Você insere um termo de pesquisa e o mecanismo consulta os servidores. Os serviços transferem os dados correlacionados para o seu navegador para você usar. É assim que a API RESTful funciona.
Agora você sabe que uma API permite que programas externos façam interface com outros programas. Uma API RESTful permite que um programa independente se comunique com um banco de dados completamente separado, como no exemplo do mecanismo de pesquisa acima.
O que faz uma API RESTful funcionar é que é sem estado e armazenável em cache. Sem estado significa que a consulta feita por uma API RESTful não tem impacto no banco de dados. A consulta não é (sempre) registrada, nada é armazenado no banco de dados e não pode ser gravado no banco de dados. É essencialmente somente leitura.
Ser armazenável em cache significa que o cliente da API pode armazenar as informações para uso futuro, para que não precise consultar o banco de dados todas as vezes.
Para a web, a API provavelmente usará o método HTTP para processar uma solicitação. Os métodos HTTP comuns são GET, POST, PUT e DELETE. No exemplo do mecanismo de pesquisa, a API RESTful usaria o método HTTP para OBTER seus dados de consulta de pesquisa no banco de dados do mecanismo de pesquisa para exibir os resultados da pesquisa.
Outro exemplo seria uma pesquisa de usuário do Twitter. Se você colocar o URL www.twitter.com/realDonaldTrump em um navegador, o navegador usará o HTTP para obter os dados de Donald Trump no Twitter e exibi-los para você. Como os nomes de usuário do Twitter são únicos, a consulta retornará os detalhes ao seu navegador.
A API RESTful é uma maneira bastante elegante de compartilhar informações sem afetar o desempenho do servidor ou revelar muito. Este tutorial apenas mostra a superfície de como eles funcionam e se integram à Web, mas deve fornecer uma idéia básica do que está acontecendo.
