Primeira corrida
- Passo 1
Abra Integrações de Desenvolvedor e revise os escopos disponíveis atualmente.
- Passo 2
Crie um token apenas para as operações necessárias.
- Passo 3
Use os exemplos e o formato de dados mostrados no painel. Mantenha o cursor ao ler eventos.
- Passo 4
Lide com interrupções, novas tentativas e nenhum evento novo. Revogue um token que você não precisa mais.
Exemplo de transmissão
Sua própria ferramenta recupera eventos subsequentes sem processar o mesmo histórico diversas vezes. O cursor permite continuar a partir da última posição e os escopos limitados do token restringem suas permissões.
Ação e possibilidades
Chaves com intervalos
Em Integrações, crie uma chave com permissões separadas para estado AO VIVO, eventos, cronômetro ou fila de música. Mostramos a chave apenas uma vez. Escolha validade de 7, 30 ou 90 dias; você pode revogá-lo a qualquer momento.
Ler e cursor
Passe a chave no cabeçalho Autorização: Portador. A leitura de eventos utiliza o cursor posterior, graças ao qual a automação não repete mensagens antigas. A primeira leitura sem cursor começa no momento atual. A leitura é limitada aos dados do proprietário da chave.
Exemplo e documentação
Baixe a descrição do OpenAPI 3.1 e a amostra de JavaScript para seu próprio servidor, Node-RED ou outro ambiente de automação. Envie uma solicitação por vez, recomendado a cada dois segundos, com limite de 60 solicitações por minuto. Não coloque a chave em HTML público ou no endereço de sobreposição.
Veja a interface de perto
Clique na ilustração para ampliá-la. As capturas de tela mostram diferentes partes da configuração; a legenda explica o que procurar.
Quando algo não funciona
A solicitação teve acesso negado
Verifique o token e o escopo necessário. Use a documentação atualizada do endpoint e o método de solicitação correto.
Os mesmos eventos se repetem
Armazene o cursor retornado e desduplicar os IDs. Não comece cada leitura desde o início da história.