Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dihub.com.br/llms.txt

Use this file to discover all available pages before exploring further.

Chave de API: Sua credencial de acesso à API da DiHub. Esta chave identifica sua conta e autoriza suas requisições. IMPORTANTE: Sem a chave de API, as requisições serão recusadas.

​
Gerenciando chaves de API

Gerencie suas chaves de API diretamente em nossa plataforma. Você pode:
  • Listar todas as chaves ativas
  • Criar novas chaves
  • Revogar chaves existentes

Erro de Autenticação

A API retornará o código HTTP 401 quando:
  • A chave de API não for fornecida no header
  • A chave for inválida
  • A chave tiver sido revogada
Quando o token é inválido ou não está presente, a API retorna a seguinte resposta: 
{
  "error": "Unauthorized",
  "message": "Missing or invalid api token"
}

​
Criando chaves de API

Boas Práticas de Segurança

  • Armazene suas chaves em variáveis de ambiente ou gerenciadores de segredos
  • Nunca compartilhe suas chaves de API
  • A DiHub nunca solicitará suas chaves
  • Revogue imediatamente qualquer chave comprometida

​
Como criar sua chave de API pela plataforma

Siga estes passos no Dashboard DiHub para criar sua chave de API:
1

Acesse o painel de API

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

Crie um novo token

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

Copie e salve seu token

Após a criação, o token será exibido na tabela. Use o ícone de copiar ao lado do token para copiá-lo e armazene-o em um local seguro — você pode copia-lo sempre que necessário.
Tabela de tokens com ícone para copiar

Desativando um token

Para desativar um token que não precisa mais ser usado, clique no ícone de lixeira na coluna Ações da tabela de Chaves de API. Tokens desativados não podem ser reativados.
Ações para desativar token
Após criar sua chave, inclua-a em todas as requisições no header X-Api-Token: 
curl 'https://api.dihub.com.br/credits/balance' \
  --header 'X-Api-Token: YOUR_API_TOKEN'

​
Ambientes

Use uma das URLs abaixo conforme o ambiente liberado para a sua conta: Produção 
https://api.dihub.com.br
Homologação 
https://homolog.api.dihubapp.com
O ambiente de homologação depende de liberação pela equipe de desenvolvimento da DiHub. A ativação feita diretamente pelo próprio usuário ainda está em desenvolvimento.
A validação padrão do token é de 90 dias.