Search docs/

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.