REST é um estilo de arquitetura para a concepção de sistemas distribuídos. Não é um padrão, não é uma tecnologia, mas é um conjunto de restrições, um conjunto de regras, tais como :

• Não possuir monitoração de estado (stateless)
• Ter um relacionamento cliente/servidor
• Ter uma interface uniforme

Embora atualmente sua implementação esteja relacionada com o HTTP ele não é restrito ao HTTP.

Ele se tornou uma alternativa mais leve e simples ao SOAP para realizar a comunicação entre serviços distribuídos entre plataformas e tecnologias diferentes. Embora o SOAP continue sendo usado o REST, a cada dia, aumenta o seu campo de atuação.

Diferente do SOAP que é baseado em ações o REST é baseado em recursos, e tem sua implementação para diversas tecnologias como Java, .NET, Node.js, Ruby, etc. baseada em 3 pilares:

• Resources
• URI
• Representação

Na figura abaixo temos uma representação esquemática do modelo REST:

Princípios REST

• Recursos - É qualquer coisa que possua um URI sendo um mapeamento conceitual para uma ou mais unidades. Um recurso pode ser um serviço que interage com qualquer coisa, como um catálogo, um dispositivo (por exemplo, uma impressora), um abridor de porta da garagem sem fio, ou um sistema interno como um CRM ou um sistema de compras.

• Representação - Uma representação é um instantâneo do estado de um recurso em um ponto no tempo. Sempre que um cliente HTTP solicita um recurso, é a representação que é retornada, e não o próprio recurso

• Mensagens - Usam métodos HTTP explicitamente. Por exemplo, GET, POST, PUT e DELETE.

• Interações sem estado (Stateless) - Não armazenam nenhum contexto de cliente no servidor entre as solicitações. O cliente mantém o estado da sessão.

Códigos de status HTTP

O cliente pode definir Accept como application/json, se ele está solicitando uma resposta no formato JSON.

Inversamente, quando enviar dados, a definição do tipo de conteúdo como application/xml diz o cliente que os dados que estão sendo enviados no request estão no formato XML.

Exemplos mais usados de media types:

• application/json
• application/x-www-form-urlencoded
• multipart/form-data
• text/html