Onde encontro a chave da API da Celetus?
api chave de acesso token integração documentação configurações
No menu Configurações, abra a aba API de Integração. A Chave de acesso aparece mascarada; use o ícone de copiar para levá-la à ferramenta que pede a chave e o ícone do olho para mostrar ou ocultar o valor. Trate a chave como uma senha e consulte a documentação da API da Celetus para saber como usá-la.
A chave de acesso da API é o código da sua conta que as ferramentas e os sistemas usam para falar com a Celetus. Você a encontra em Configurações → aba API de Integração, no campo Chave de acesso, que mostra o valor mascarado e tem ícones para copiar e para mostrar ou ocultar. A API é a porta de comunicação que deixa um sistema conversar com o outro sem você digitar nada.
Como encontrar e copiar a chave
Passo a passo
- No menu lateral, abra Configurações.
- Clique na aba API de Integração (na tela, o nome aparece escrito APi de Integração). O quadro Dados da API mostra a Versão atual da API e um link para a documentação.
- Em Chave de acesso, clique no ícone de copiar. A chave vai para a área de transferência, sem aparecer na tela.
- Se precisar conferir o valor, clique no ícone do olho para mostrar e clique de novo para ocultar.
O campo é apenas de leitura: você copia a chave, mas não a edita nessa tela. Não encontramos, nessa tela, botões para gerar uma chave nova ou revogar a atual. Se você acha que a chave vazou, fale com o suporte sem informar o valor dela.
Onde a chave é pedida
| Onde | Como aparece |
|---|---|
| Webhooks (em Apps) | O campo Token exibe a chave da sua conta, e a Celetus a envia no cabeçalho Api-Token de cada aviso. Veja Como configurar um webhook. |
| Notazz (ferramenta de nota fiscal) | Você cola a chave no campo Token da Notazz. Veja Como emitir nota fiscal das vendas da Celetus com a Notazz?. |
| Sistemas próprios | Um desenvolvedor usa a chave nas chamadas à API, conforme a documentação. |
Cada ferramenta tem o seu nome para o campo; a chave copiada aqui é a mesma.
Onde está a documentação da API?
No quadro Dados da API, o link Acesse nossa documentação para saber mais abre a documentação. A documentação atual da API da Celetus está em docs.celetus.com; use esse endereço. Essa documentação explica o que cada chamada faz, e quem monta a integração costuma ser um desenvolvedor.
Perguntas frequentes
A chave de acesso é a mesma coisa que o token do webhook?
Na tela de webhooks, o Token é o valor da chave da sua conta. Para entender o que o webhook envia, veja Quais eventos e dados o webhook envia?.
Posso gerar uma chave nova?
A tela API de Integração só mostra e copia a chave atual: não encontramos nela botão para gerar ou revogar. Se você acha que a chave vazou ou precisa de outra, fale com o suporte, sem informar o valor dela, para saber o que é possível.
Por que a chave aparece em pontinhos?
Para evitar que alguém a veja por cima do seu ombro. Use o ícone do olho só quando precisar conferir.
Para ver tudo o que se conecta à Celetus, veja Quais integrações a Celetus oferece?.