> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

> Toda requisição de cliente carrega um token bearer.

Envie sua chave de API como token bearer em toda requisição:

```bash theme={null}
curl "$BASE/v1/async/task/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"
```

Uma chave ausente ou incorreta retorna `401`:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key",
    "timestamp": "2026-07-09T04:12:00.000Z"
  }
}
```

## Quais endpoints exigem

| Endpoint | Autenticação |
| - | - |
| `POST /v1/async/task` | Bearer |
| `POST /v1/async/task/batch` | Bearer |
| `GET /v1/async/task/{id}` | Bearer |
| `GET /stats` | Bearer |
| `GET /capacity` | Bearer |
| `GET /health` | Nenhuma (sonda de liveness) |
| `GET /ready` | Nenhuma (sonda de readiness) |

## Como obter uma chave

As chaves são emitidas no onboarding. Fale com a gente em [querying.ai](https://querying.ai) para solicitar acesso.