Como usar a API e os tokens de acesso
A API do Rabbiit deixa outro sistema consultar e gravar dados da conta — relatórios, lançamentos, projetos — em nome de um usuário. Cada integração usa um token de acesso. Quem tem o token opera com o mesmo nível de permissão daquela pessoa.
Isso é diferente de webhook: a API você chama quando precisa; o webhook o Rabbiit dispara sozinho quando o evento acontece.
💡 Plano: o painel de Integrações (consumo, tokens da conta e permissão de criação) faz parte do Ultimate. Cada plano tem um limite diário de requisições. A documentação dos endpoints está em api-docs.rabbiit.com.
Para quem é
Tela de tokens pessoais da API
Administrador — acompanha o consumo, define quem pode criar token e revoga acesso quando alguém sai ou um fornecedor deixa de prestar serviço.
Quem integra (admin, superusuário ou membro, conforme a configuração) — gera o próprio token em Meus Tokens e guarda no cofre da integração.
Colaborador sem permissão de token — não cria chave. Continua só lançando horas.
Onde encontrar
Há duas telas:
- Configurações > Integrações — o administrador vê o uso da API, quem pode criar tokens e a lista de tokens da conta.
- Você > Meus Tokens — cada pessoa autorizada cria e revoga os seus tokens.
As duas convivem: a criação é pessoal; a visão da conta é do administrador.
Gerenciamento da API
Gerenciamento da API com o consumo diário de requisições
Em Configurações > Integrações, aba Gerenciamento da API:
- Uso diário da API — barra de progresso com quantas requisições já foram feitas e quantas restam.
- O limite é compartilhado entre todos os tokens da conta. Não é um teto por pessoa.
- O painel mostra quando o limite renova.
- Há limite. Se a conta chega no teto do plano, as chamadas passam a ser recusadas até a renovação — ou até um upgrade.
Na mesma aba o administrador define quem pode criar tokens pessoais:
- Somente administradores
- Administradores e superusuários
- Todos os membros
Só o administrador altera essa configuração. Quem não está no grupo escolhido não vê Meus Tokens (ou não consegue criar).
Meus Tokens
Cada pessoa autorizada abre Você > Meus Tokens e cria as próprias chaves.
- Clique em Novo token.
- Dê um nome que identifique o destino (“ERP do cliente X”, “Script de relatório”).
- Ao criar, o valor do token aparece uma vez. Copie e guarde no cofre da integração; ele não volta a ser exibido por inteiro.
- Quem tiver o token tem o mesmo acesso do seu usuário na API. Não compartilhe a mesma chave com todo mundo — um token por integração.
- Revogue assim que o acesso não for mais necessário (projeto acabou, ferramenta trocou, você saiu daquela operação).
Na lista aparecem nome, final do token (para conferir com o que você guardou), data de criação e último acesso.
Tokens da conta (administrador)
Em Configurações > Integrações, aba Tokens da conta, o administrador vê os tokens pessoais ativos de cada pessoa: proprietário, nome, final do token, criação e último acesso.
Dali dá para revogar o token de qualquer um. A integração que usava aquela chave deixa de autenticar na hora. Use quando a pessoa saiu, um fornecedor encerrou ou uma chave vazou.
O administrador não cria o token “pela” outra pessoa nesta aba — cada um gera o seu em Meus Tokens. Aqui a função é visibilidade e revogação.
Quando usar a API (e quando o webhook)
Use a API quando o outro sistema puxa um relatório, sincroniza um cadastro ou grava um lançamento sob demanda.
Use webhook quando o outro sistema precisa reagir no momento do evento (hora lançada, semana aprovada, projeto criado).
Se a conta não integra com nada, ignore estas telas. Relatórios e a timesheet cobrem o dia a dia sem token.