Explique os princípios e a ideologia principal da API RESTful

API RESTful é um estilo arquitetónico para criar serviços web, baseado nos princípios REST (Transferência de Estado Representacional). Ideias principais:

• Recursos: Tudo o que trabalha com a API é apresentado como recursos (por exemplo, utilizadores, produtos), que são identificados por URIs únicos.

• Métodos HTTP: Para interagir com os recursos, usam-se métodos HTTP padrão:

  • GET — obter dados do recurso;
  • POST — criar um novo recurso;
  • PUT — atualizar o recurso;
  • DELETE — eliminar o recurso.

• Códigos de estado: As respostas do servidor contêm códigos de estado HTTP que informam sobre o resultado da operação (por exemplo, 200 OK, 404 Não Encontrado).

• Sem estado (stateless): Cada pedido do cliente ao servidor deve conter toda a informação necessária para o processamento, o servidor não mantém estado entre pedidos.

• Caching: As respostas podem ser armazenadas em cache para melhorar o desempenho.

• Interface uniforme: Facilita a interação e compreensão da API.

Exemplo de uma requisição a uma API RESTful para obter a lista de utilizadores:

GET /users HTTP/1.1
Host: example.com
Accept: application/json

Resposta:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

Assim, a API RESTful fornece uma interação simples, compreensível e padronizada entre cliente e servidor.