Vamos nos aprofundar no que é uma API REST e como ela funciona, já que estamos prestes a construí-la. Compreender esses conceitos fundamentais fornecerá uma base sólida para o restante do nosso projeto.

Plano

• 🤔 O que é uma API REST?
• 🔍 Princípios-chave do REST;
• 🤷‍♂️ Como funcionam as APIs REST.

🤔 O que é uma API REST?

REST, ou Transferência de Estado Representacional, é um estilo arquitetural para projetar aplicações em rede. APIs REST são um conjunto de regras para criar e interagir com serviços web, facilitando a troca de dados e operações entre sistemas de software.

🔍 Princípios Fundamentais do REST

Para compreender a essência das APIs REST, é fundamental lembrar destes princípios centrais:

• Ausência de Estado: Em REST, cada interação entre cliente e servidor é independente. Todas as informações necessárias devem estar incluídas na própria requisição;
• Centrado em Recursos: REST trata tudo como um recurso, identificando cada recurso de forma única por um URI (Identificador Uniforme de Recurso). Esses recursos interagem por meio de métodos HTTP padrão como GET, POST, PUT e DELETE;
• Representação: Recursos em REST podem ter múltiplas representações, como JSON ou XML. Essa flexibilidade permite que os clientes escolham o formato preferido para a troca de dados.

🤷‍♂️ Como as APIs REST Funcionam

Agora, vamos analisar mais de perto como as APIs REST funcionam. O processo envolve várias etapas principais:

1. Requisição: Clientes iniciam requisições fornecendo todos os detalhes necessários em cada requisição. Isso inclui o método HTTP, URI e parâmetros ou dados exigidos;
2. Recurso: A API processa a requisição com base no URI único do recurso. Esse URI serve como endereço para o recurso solicitado;
3. Métodos HTTP: Métodos HTTP padrão determinam o tipo de operação a ser realizada. Por exemplo, GET é utilizado para recuperação, POST para criação, PUT para atualização e DELETE para remoção;
4. Resposta: Após processar a requisição, o servidor envia uma resposta no formato de representação escolhido, normalmente JSON ou XML. Essa resposta contém os dados solicitados ou a confirmação da ação realizada;
5. Ausência de Estado: As interações REST são projetadas para serem sem estado, ou seja, nenhum dado de sessão é armazenado entre as requisições. Cada requisição é independente e autossuficiente.