Crie e revogue tokens de API
O que um token pode fazer
Um token age em nome da pessoa que o criou, na equipe que estava ativa naquele momento. Ele só pode fazer o que você permitir ao criá-lo. Você escolhe uma destas opções:
- Controlar telas e cenas: ver telas, conteúdo e cenas, mostrar conteúdo em uma tela e iniciar e parar cenas. Use esta opção para o Bitfocus Companion.
- Somente leitura: ver telas, conteúdo e cenas, e nada mais.
- Acesso total, incluindo a criação de designs: tudo o que está acima, mais a criação de designs.
Se a pessoa que criou o token perder o acesso à equipe, o token deixa de funcionar.
Crie um token
- Vá em Configurações > Conexões.
- Em Tokens de API, clique em Novo token de API.
- Dê um nome ao token, por exemplo o nome do local ou do programa que vai usá-lo.
- Em Acesso, escolha o que o token pode fazer.
- Clique em Criar token.
- Clique em Copiar e guarde o token em um lugar seguro, por exemplo no programa que precisa dele.
- Clique em Concluído.
Você vê o token apenas uma vez. Se o perder, revogue-o e crie um novo.
O token funciona na equipe que está ativa quando você o cria. Para as telas de outra equipe, mude primeiro para essa equipe e crie um token separado. Use um token separado para cada programa, para poder revogar um sem interromper os outros.
Por padrão, o proprietário e os administradores podem criar tokens. Isso depende da sua função. Você muda isso por função em Gerencie equipes.
E-mail ao criar um token
Quando alguém cria um token, essa pessoa e os proprietários da conta recebem um e-mail. O e-mail informa qual é o token, quem o criou, para qual equipe, quando e o que ele pode fazer. O e-mail nunca contém o token em si. Se você não esperava um token, revogue-o imediatamente.
Veja os seus tokens
O cartão Tokens de API mostra, para cada token:
- o nome e o tipo de acesso;
- os últimos quatro caracteres do token, para você distinguir um do outro;
- a equipe;
- quando foi usado pela última vez, ou Nunca usado.
O proprietário vê os tokens de todos os membros da conta. Os demais veem apenas os próprios.
Revogue um token
- Vá em Configurações > Conexões.
- Clique em Revogar ao lado do token.
- Confirme com Revogar.
Tudo o que usa o token para de funcionar na hora.
Tokens que expiram
Um token que ficou um ano sem ser usado é revogado automaticamente. Um token que nunca foi usado conta a partir do dia em que foi criado. Crie um novo token se precisar de um de novo.
Limite
Uma conta pode ter um número limitado de tokens. Quando você chega a esse limite, o Screenbird pede que você revogue um primeiro.
Apps conectados
Os apps que você conecta com um login do Screenbird, em vez de um token, aparecem no próprio cartão Apps conectados, na mesma página. Clique em Desconectar para remover um.
Crie a sua própria conexão
O Screenbird tem uma API pública. Envie o seu token como bearer token em cada requisição. A descrição completa da API, com todas as requisições e as permissões que cada uma exige, está em api.screenbird.app/v1/openapi.json.