Skip to main content
Toda requisição à API da DiHub precisa de um token de API no header X-Api-Token. O token identifica o seu usuário: a emissão consome os créditos dele e da organização dele. Sem token válido, a API recusa a requisição com 401.

Como criar um token

No Dashboard DiHub:
1

Acesse a página de API

No menu da sua conta (canto superior direito), clique em API para abrir a página Chaves de API.
Menu Minha conta com opção API
2

Crie um novo token

Clique em + Criar Novo Token, no canto superior direito.
Botão Criar Novo Token na página de Chaves de API
3

Copie o token

O token aparece na tabela. Use o ícone de copiar ao lado dele. Você pode copiá-lo de novo sempre que precisar.
Tabela de tokens com ícone para copiar
Na mesma página você vê os tokens ativos e desativa os que não usa mais.
O token vale por 90 dias a partir da criação. Depois disso, crie um novo.

Como desativar um token

Clique no ícone de lixeira na coluna Ações da tabela de Chaves de API. A desativação é imediata e não tem volta: um token desativado não pode ser reativado.
Ações para desativar token

Erros de autenticação

A API retorna 401 nestes casos:

Boas práticas

  • Guarde o token em variável de ambiente ou gerenciador de segredos, nunca no código.
  • Não compartilhe o token. A DiHub nunca pede o seu token.
  • Desative na hora qualquer token que possa ter vazado.

Ambientes

Produção
Homologação
O acesso à homologação é liberado pela equipe da DiHub. Peça pelo e-mail claudiolima@dihub.com.br.