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

# Visão Geral da API

> Entenda o que você precisa e o detalhe da documentação dos endpoints

## Ambientes

### 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 precisa ser liberado pela equipe da DiHub. A habilitação desse acesso pelo próprio usuário ainda está em desenvolvimento.
</Warning>

## Autenticação

Todas as rotas exigem o header `X-Api-Token`.

```bash theme={null}
X-Api-Token: YOUR_API_TOKEN
```

<Card title="Como gerar seu token" icon="key" href="/introduction/authentication">
  Veja como criar, copiar e revogar tokens no dashboard.
</Card>

## Fluxo básico

1. Gere seu token de API.
2. Consulte `GET /credits/balance` para validar seu saldo.
3. Envie `POST /diligences/emit` para iniciar a diligência.
4. Acompanhe o processamento e baixe os arquivos quando estiverem prontos.

<Info>
  Use a página [Consumo de créditos](/reference/consumo-creditos) para validar a cobrança antes de integrar fluxos em lote.
</Info>

## Atalhos

<CardGroup cols={2}>
  <Card title="Saldo de créditos" icon="wallet" href="/api-reference/credits/balance">
    Consulte o saldo atual da conta autenticada.
  </Card>

  <Card title="Emitir diligência" icon="file-certificate" href="/api-reference/diligences/emit">
    Inicie uma diligência com certidões, análise de crédito ou ambos.
  </Card>

  <Card title="Consumo de créditos" icon="calculator" href="/reference/consumo-creditos">
    Veja a regra de cobrança por cenário.
  </Card>

  <Card title="Todas as certidões" icon="list-check" href="/reference/todas-certidoes">
    Consulte a lista consolidada de certidões emitidas pela plataforma.
  </Card>
</CardGroup>