> ## 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.

# Autenticação

> Como enviar requisições para a nossa API

<Tip>
  **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.
</Tip>

## <Icon icon="lock" type="solid" />  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

<Card title="Erro de Autenticação" icon="warning" horizontal>
  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
</Card>

Quando o token é inválido ou não está presente, a API retorna a seguinte resposta:

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Missing or invalid api token"
}
```

## <Icon icon="key" type="solid" />  Criando chaves de API

<Card title="Boas Práticas de Segurança" icon="light-emergency-on" horizontal>
  * 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
</Card>

## Como criar sua chave de API pela plataforma

Siga estes passos no [Dashboard DiHub](https://app.dihub.com.br) para criar sua chave de API:

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/dihub/iCpIkD-rJTKe6Gqn/images/entrar-no-painel-de-api.png?fit=max&auto=format&n=iCpIkD-rJTKe6Gqn&q=85&s=37b9dcf2919df7cf1007bfc3ed850169" alt="Menu Minha conta com opção API" width="3554" height="2074" data-path="images/entrar-no-painel-de-api.png" />
    </Frame>
  </Step>

  <Step title="Crie um novo token">
    Na página **Chaves de API**, clique no botão **+ Criar Novo Token** no canto superior direito.

    <Frame>
      <img src="https://mintcdn.com/dihub/dd-6j80g45xXspAW/images/criar-novo-token.png?fit=max&auto=format&n=dd-6j80g45xXspAW&q=85&s=1cbdc9fe5d19b93364fa0f79146cb2e0" alt="Botão Criar Novo Token na página de Chaves de API" width="1913" height="824" data-path="images/criar-novo-token.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/dihub/dd-6j80g45xXspAW/images/copiar-e-salvar-o-token.png?fit=max&auto=format&n=dd-6j80g45xXspAW&q=85&s=38b84c84823616001f2b37ee1ed158bb" alt="Tabela de tokens com ícone para copiar" width="1689" height="366" data-path="images/copiar-e-salvar-o-token.png" />
    </Frame>
  </Step>
</Steps>

<Card title="Desativando um token" icon="trash" horizontal>
  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.

  <Frame>
    <img src="https://mintcdn.com/dihub/dd-6j80g45xXspAW/images/desativar-o-token.png?fit=max&auto=format&n=dd-6j80g45xXspAW&q=85&s=2738285b6ee75362a22724303c818e44" alt="Ações para desativar token" width="1762" height="385" data-path="images/desativar-o-token.png" />
  </Frame>
</Card>

Após criar sua chave, inclua-a em todas as requisições no header `X-Api-Token`:

```bash theme={null}
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**

```bash theme={null}
https://api.dihub.com.br
```

**Homologação**

```bash theme={null}
https://homolog.api.dihubapp.com
```

<Warning>
  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.
</Warning>

A validação padrão do token é de 90 dias.