Pular para o conteúdo principal
A API pública usa API keys no formato wd_live_<prefixo>_<segredo>. Envie a key em um destes headers:

​
Criando e gerenciando keys

Somente administradores podem gerenciar keys, em Configurações → API Keys:
  • Escopos — o que a key pode ler ou alterar. Veja Escopos.
  • Expiração — nunca, 30, 90 ou 365 dias. Keys expiradas retornam 401.
  • Revogação — imediata; leva até 60 segundos para propagar entre instâncias.
  • Último uso — exibido na listagem, útil para identificar keys esquecidas.
A key completa é exibida uma única vez, na criação. O WiseDesk guarda apenas um hash (bcrypt). Se perdê-la, revogue e gere outra.

​
Em nome de quem a key age

Cada key pertence a uma empresa e age em nome do administrador que a criou. Comentários, mensagens e tasks criados pela API aparecem com esse autor no histórico.
  • Os dados retornados são sempre restritos à empresa da key — não há como acessar outra empresa.
  • Campos companyId enviados no corpo das requisições são ignorados.

​
Boas práticas

Facilita identificar a origem das chamadas e revogar sem afetar outras integrações.
Conceda apenas os escopos necessários. Um painel de BI precisa só de analytics:read.
Nunca exponha a key em apps web/mobile. Faça as chamadas a partir do seu servidor.
Use expiração e gere uma nova key antes do vencimento.