9. O que são API's REST

APIs REST, ou Representational State Transfer (REST), são um estilo arquitetural de software que define um conjunto de restrições para serem usadas para criar serviços web. REST é uma alternativa popular a outros métodos de desenvolvimento de APIs, como SOAP, devido à sua simplicidade e ao fato de ser construído sobre os padrões existentes da web, como HTTP.

Em termos simples, uma API REST é uma maneira de os desenvolvedores interagirem com um determinado software ou serviço. Ela fornece uma interface que pode ser usada para solicitar dados de um servidor, enviar dados para um servidor ou realizar outras operações em um servidor. Essas solicitações são feitas usando os métodos HTTP padrão, como GET, POST, PUT e DELETE.

Uma das principais características das APIs REST é a sua natureza stateless. Isso significa que cada solicitação feita a um servidor é independente e não tem conhecimento das solicitações anteriores. Isso é importante porque permite que as APIs REST sejam altamente escaláveis, uma vez que o servidor não precisa manter informações de estado para cada cliente. Em vez disso, todas as informações necessárias para processar uma solicitação são enviadas com a própria solicitação.

Outra característica importante das APIs REST é a sua aderência ao princípio da uniformidade de interface. Isso significa que todas as solicitações feitas a uma API REST seguem a mesma estrutura básica, independentemente do tipo de dados que estão sendo solicitados ou da operação que está sendo realizada. Isso torna as APIs REST muito fáceis de usar e entender, pois os desenvolvedores não precisam aprender uma nova interface para cada serviço diferente com o qual estão trabalhando.

As APIs REST também são projetadas para serem cacheáveis, o que significa que as respostas a determinadas solicitações podem ser armazenadas e reutilizadas, reduzindo a quantidade de tráfego de rede e melhorando o desempenho. Além disso, as APIs REST são normalmente projetadas para serem sem camadas, o que significa que um cliente pode se comunicar diretamente com um servidor sem a necessidade de passar por intermediários.

Em termos de formato de dados, as APIs REST normalmente usam JSON (JavaScript Object Notation) como formato de dados padrão para enviar e receber dados. O JSON é um formato de dados leve e fácil de usar que pode ser facilmente convertido em objetos JavaScript, tornando-o uma escolha popular para APIs REST.

Para ilustrar como uma API REST funciona, considere o exemplo de uma API REST que permite a um cliente solicitar informações sobre um livro em uma biblioteca. O cliente faria uma solicitação GET para a URL da API, incluindo o ID do livro como parte da URL. A API então retornaria um objeto JSON contendo todas as informações sobre o livro, como o título, o autor e a data de publicação.

Se o cliente quisesse atualizar as informações de um livro, ele faria uma solicitação PUT para a URL da API, incluindo o ID do livro e um objeto JSON contendo as novas informações do livro. A API então atualizaria as informações do livro no servidor e retornaria uma resposta confirmando que a operação foi bem-sucedida.

Em resumo, as APIs REST são uma maneira poderosa e flexível de criar serviços web. Elas são fáceis de usar, altamente escaláveis e construídas sobre os padrões existentes da web, tornando-as uma escolha popular para muitos desenvolvedores.

Próxima página do Ebook Gratuito:

65Criando uma API REST básica com NodeJS e ExpressJS

3 minutos