Publishers

Os publicadores (publishers) são as aplicações ou parceiros que enviam dados ao Sensedia Events Hub, comunicando eventos que serão distribuídos aos subscritores.

Os publicadores enviam eventos para tópicos, que definem a URL de publicação. Por isso, no processo de registro de publicadores, você precisa habilitar os tópicos que cada publicador poderá enviar requisições.

Lista de publishers

Na tela de Publishers, você pode ver todos os seus publicadores e cadastrar novos.

publisher screen

Você pode buscar um publicador específico usando os filtros do topo da página. Eles permitem pesquisar por:

  • data inicial e final de criação;

  • nome do publicador;

  • e-mail do desenvolvedor responsável;

  • client ID;

  • status; ou

  • nome do handler.

Use o campo Order by para definir a ordenação da lista. Você pode escolher visualizar pela data de criação mais recente ou mais antiga, ou por ordem alfabética.

Clicando sobre o nome de um publicador, você é direcionado para a tela de Overview. Nela, você pode:

  • visualizar e editar as informações do publicador no botão Edit Publisher;

  • deletar o publicador clicando no ícone icon delete;

  • habilitar ou desabilitar tópicos para a publicação no botão Edit Enabled Topics.

overview publisher

Criando publishers

O Events Hub permite criar publicadores manualmente ou importá-los de uma app da Sensedia API Platform.

publisher creation

Para iniciar, clique no botão icon add. Na tela que abrir, escolha de que forma quer criar o publicador:

Importando uma app

Para criar a partir de uma app cadastrada na Sensedia API Platform, siga os passos:

  1. Clique no botão Import from API Management;

  2. No campo APP NAME, digite ou busque na lista o nome da app que deseja importar.
    Ao fazer isso, todos os campos da seção Overview são preenchidos automaticamente e não podem ser editados;

  3. Clique em Save;

  4. Clique em ADD ENABLED TOPICS para vincular o publicador aos tópicos;

  5. Ao escolher um tópico, clique no ícone icon view topics;

  6. Na tela que abrir, clique no ícone icon expand e habilite também o contexto a que o publicador terá permissão;

  7. Clique em Done para salvar as alterações.

Cadastrando manualmente

Para criar um publicador do zero, siga os passos:

  1. Na seção Overview, preencha os campos:

    • Name: nome do publicador, que deve ser único;

    • Status: selecione entre aprovado (approved), pendente (pending), rejeitado (rejected) ou cancelado (canceled);

    • Description: campo não obrigatório para incluir uma descrição;

    • Developer: email do desenvolvedor responsável pelo publicador;

    • Client ID: identificação do publicador para quando o evento for recebido pelo Events Hub.

  2. Clique em Save and Next;

  3. Clique em ADD ENABLED TOPICS para vincular o publicador aos tópicos;

  4. Ao escolher um tópico, clique no ícone icon view topics;

  5. Na tela que abrir, clique no ícone icon expand e habilite também o contexto a que o publicador terá permissão;

  6. Clique em Done para salvar as alterações.

A seção Topics serve para habilitar os tópicos que o publicador poderá enviar eventos. Os tópicos são criados por meio dos handlers e são habilitados em contextos. Isso permite que você use contextos específicos para publicadores em um mesmo tópico.

Imagine que você quer que o "Publisher A" publique eventos para o tópico "Outlet".
Ao mesmo tempo, sua equipe de desenvolvimento precisa também testar esse tópico, mas usando um endpoint mock de autorização.
Para isso, você pode criar um contexto para testes chamado "Testing", por exemplo, e habilitar o tópico "Outlet" para o contexto padrão ("Default") e para o "Testing".

Os endpoints de autorização são definidos por contexto. Isso permite configurar um mock para "Testing" e manter o contexto padrão com a autorização real.
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]