Autenticação
Gere o token de API no Wiboor e envie em todas as requisições
A API do Wiboor usa Bearer Token. Cada token pertence a um usuário: a API enxerga e altera o que esse usuário pode ver e fazer no Wiboor.
Gere seu token
- Entre na sua conta em wiboor.com.br.
- Clique no botão do seu perfil (o último do painel lateral) e escolha Token.
- Clique em Gerar Token e copie o token exibido.
O token aparece uma vez só
Guarde-o num lugar seguro, como o cofre de segredos do seu servidor. Se você gerar um token novo, o anterior deixa de funcionar na hora.
Envie o token nas requisições
Inclua o token no header Authorization de todas as chamadas:
Terminal
curl "https://api.azzimuti.com.br/v1/departments" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json"| Header | Valor |
|---|---|
Authorization | Bearer SEU_TOKEN |
Content-Type | application/json (nas requisições com corpo) |
Na referência da API, cole o token no campo de autenticação para testar as chamadas direto na página.
O token do Try It fica salvo neste navegador
Para você não precisar colar de novo, o token digitado na referência fica guardado no navegador. Teste só num computador seu, nunca num compartilhado.
Respostas de autenticação
| Status | Quando acontece |
|---|---|
401 | Token ausente, inválido ou revogado (por exemplo, depois de gerar um token novo) |
403 | O token é válido, mas o usuário não tem permissão para a ação. Exemplo: só quem solicitou a tarefa ou um gestor pode editá-la |
Boas práticas
- Use o token só no seu backend. Nunca o coloque em código que roda no navegador ou no app do usuário.
- Crie um usuário de integração no Wiboor quando as tarefas precisarem aparecer como abertas pelo sistema, e não por uma pessoa.
- Ao trocar o token, atualize todos os sistemas que usam o anterior.