O que é uma API REST?

REST API é um estilo arquitetónico, não um padrão, para construir sistemas distribuídos. Baseia-se em princípios como a ausência de estado, arquitetura cliente-servidor e uso de métodos HTTP padrão (GET, POST, PUT, DELETE, PATCH) para operações sobre recursos.

Princípios-chave do REST:

• Sem estado (stateless): O servidor não armazena informações sobre o estado do cliente entre pedidos. Cada pedido contém toda a informação necessária para o seu processamento.
• Cliente-Servidor: Separação clara entre cliente e servidor. Cada um pode evoluir independentemente.
• Cacheável: As respostas podem ser marcadas como cacheáveis ou não cacheáveis, o que melhora o desempenho.
• Sistema em camadas: O cliente não consegue saber se está conectado diretamente ao servidor ou através de camadas intermédias.
• Interface uniforme: Formas padronizadas de interagir com recursos. Inclui:
  • Identificação de recursos (URI)
  • Manipulação de recursos através de representações
  • Mensagens auto-descritivas
  • Hypermedia como o motor do estado da aplicação (HATEOAS) - o estado da aplicação é gerido através de hiperligações.

Exemplo de uso de métodos HTTP padrão:

Método HTTP	Ação sobre o recurso (por exemplo, /users)	Descrição
GET	/users ou /users/{id}	Obter lista de utilizadores ou um utilizador específico.
POST	/users	Criar um novo utilizador.
PUT	/users/{id}	Atualização completa dos dados do utilizador pelo seu ID.
PATCH	/users/{id}	Atualização parcial dos dados do utilizador pelo seu ID.
DELETE	/users/{id}	Eliminar utilizador pelo seu ID.

REST API é usada para interação entre diferentes sistemas e aplicações, por exemplo, entre frontend e backend.