Layers API Hub
O Layers API Hub é uma funcionalidade do ecossistema Layers que permite Apps proverem/fornecerem informações para outros Apps na Layers. Isto é feito através de actions: um protocolo que especifica o formato de comunicação entre os provedores e fornecedores de informação.
Para cada uma dessas actions, está disponível um App desenvolvido pela Layers que disponibiliza essas informações. Assim, Apps provedores podem se responsabilizar apenas em disponibilizar as informações e nossos apps se responsabilizam por expor essas informações da melhor maneira para os usuários da Layers.
Como funciona ?
A troca de informações entre apps por meio do API Hub pode ser descrita em quatro etapas:
- 1 - App requisita informações
A troca de informações entre apps da Layers começa com o app que necessita de informações fazendo uma requisição
POST
para a Layers seguindo o padrão estabelecido pela action especificada como parâmetro na URL.
- 2 - Layers repassa a requisição
Uma vez que a Layers recebe a requisição, o corpo é validado de acordo com o protocolo da action. Se o formato da requisição estiver de acordo com o formato especificado, a Layers repassa a requisição para o provedor especificado como parâmetro na URL adicionando informações de contexto da requisição.
- 3 - App responde a requisição
O app provedor registrado recebe então a requisição vinda da Layers na URL especificada quando ele foi cadastrado como provedor para a action que foi requisitada. A resposta deve seguir o formato especificado pelo protocolo da action.
- 4 - Layers repassa a resposta
Ao receber a resposta do provedor, a Layers verifica se ela está de acordo com o protocolo da action e repassa as informações recebidas para o app que as requisitou.