Integração de dados na Tekon IoT Platform por REST API - Princípios do REST API

REST, acrónimo de Representational State Transfer, é um estilo de arquitectura de software. É baseado em 5 princípios mandatórios e 1 opcional, que descrevem como os recursos em rede são definidos e endereços na Internet.

API, acrónimo de Application Program Interface, é um conjunto de regras que permite que duas aplicações diferentes, comuniquem entre si pela Internet e através de vários dispositivos.

Príncipios do REST API

Cliente-Servidor: cliente e servidor estão separados em toda a arquitetura. A divisão entre estas partes facilita a portabilidade da interface do utilizador entre várias plataformas.

Stateless: os pedidos do cliente para o servidor devem conter todas as informações necessárias para processar o pedido. Não existe estado da sessão do lado do servidor, sendo este mantido no lado do cliente. Caso o acesso a um recurso obrigue a uma autenticação, o cliente deverá realizar a autenticação em cada pedido.

Cache: uma API sem estado pode aumentar a sobrecarga de um pedido, lidando com grandes quantidades de pedidos de entrada e saída de dados, os dados podem ser armazenados em cache pelo cliente, servidor ou outro intermediário. Os dados de resposta devem ser categorizados como armazenáveis em cache ou não. Se uma resposta for passível de ser armazenada em cache, à cache do cliente será concedido o direito de reutilizar esses dados de resposta para pedidos equivalentes que sejam feitos posteriormente.

Interface uniforme: para separar o cliente do servidor, é necessário ter uma interface uniforme que permita a evolução da aplicação sem ter os serviços da aplicação ou modelos e ações, associados à própria camada da API.

Sistema de camadas: os componentes individuais não podem ver além do nível com o qual interagem. Isso significa que um cliente que se liga a um componente intermediário, como por exemplo um proxy, não sabe o que está por trás dele. Logo, os componentes podem ser trocados independentemente uns dos outros.

Código a pedido (opcional): permite que código ou applets sejam transferidos via API para usar dentro de uma aplicação.

Os métodos usados pelos REST API são idênticos aos disponibilizados pelo HTTP – POST, GET, PUT, DELETE, etc.