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

# Referência da API

> Use a API REST da Aira para integrar eventos de uso, gerenciar clientes, consultar faturas e automatizar seu fluxo de faturamento.

> A API da Aira permite que você integre seu produto diretamente ao sistema de faturamento — enviando eventos de uso, gerenciando clientes e consultando faturas programaticamente.

<h2 id="visao-geral">
  Visão geral
</h2>

A API segue o padrão REST com respostas em JSON. Todas as requisições são autenticadas via chave de API no header `X-API-KEY`.

**Base URL:**

```
https://api.useaira.com
```

**Endpoints disponíveis:**

| Recurso  | Endpoints                    | Descrição                       |
| -------- | ---------------------------- | ------------------------------- |
| Eventos  | `POST /v1/events/ingest`     | Envio de eventos de uso em lote |
| Clientes | `POST`, `GET /v1/customers/` | Criar e consultar clientes      |
| Recursos | `POST`, `GET /v1/resources/` | Criar e consultar recursos      |
| Faturas  | `GET /v1/invoices/`          | Consultar faturas e baixar PDFs |

<br />

<h2 id="comece-por-aqui">
  Comece por aqui
</h2>

<CardGroup>
  <Card title="Autenticação" icon="key" href="/api-reference/autenticacao">
    Configure sua chave de API e entenda o modelo de permissões.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks">
    Receba notificações em tempo real sobre mudanças de status de faturas.
  </Card>

  <Card title="Respostas de erro" icon="triangle-exclamation" href="/api-reference/error-responses">
    Entenda o formato de erros e os códigos de status HTTP.
  </Card>
</CardGroup>