Nesta seção3 artigos
Criar e revogar um token
Crie um token pessoal de API em Configurações → API, copie-o uma vez e revogue-o lá quando um app não precisar mais dele.
Você precisa do plano Label para criar um token. Veja Acesso à API no plano Label. Crie e revogue tokens com login no app: um token não pode criar nem revogar outros tokens.
Criar um token
- Confira se o espaço de trabalho certo está ativo. O token lê os dados do espaço de trabalho em que você está agora.
- Abra Configurações → API e selecione Novo token.
- Digite um Nome do token que diga onde você o usa, por exemplo “pipeline de CI”. Selecione Criar token.
- Selecione Copiar token e guarde o token em um lugar seguro, como um gerenciador de senhas ou as configurações secretas do seu app.
- Selecione Já salvei.
Veja seus tokens
Configurações → API lista seus tokens ativos do espaço de trabalho atual com nome, início do token, quando você o criou e quando foi o Último uso. Nunca significa que nenhuma requisição o usou ainda.
Revogar um token
- Em Configurações → API, encontre o token na lista. Na web, selecione o ícone de lixeira ao lado dele. Nos apps, selecione Revogar.
- Em Revogar este token?, selecione Revogar token.
Qualquer app que use o token para de funcionar na hora. Não dá para desfazer. Revogar libera uma vaga, então você pode criar um novo token.
Nos apps para iPhone e Android
Configurações → API nos apps funciona do mesmo jeito. O campo Nome do token e o botão Criar token ficam sempre na página, o novo token aparece em Seu novo token e cada token da lista tem um botão Revogar.
Perguntas
Perdi meu token de API. Posso vê-lo de novo?
Não. Mostramos o token completo só uma vez. Revogue o token perdido em Configurações → API e crie um novo.
Sair da conta revoga meus tokens de API?
Não. Sair encerra suas sessões no app, mas os tokens continuam funcionando até você revogá-los. Sair de um espaço de trabalho, ser removido dele ou excluir sua conta encerra os tokens dele.
Por que não consigo criar outro token?
Você pode ter 5 tokens ativos. Revogue um que você não usa mais e crie o novo.
