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

# Visão Geral

> Referência completa das APIs públicas do Metrito

O Metrito expõe três APIs com finalidades distintas:

| API              | URL Base                  | Finalidade                                      |
| ---------------- | ------------------------- | ----------------------------------------------- |
| **Plataforma**   | `https://api.metrito.com` | Autenticação, projetos e conexões               |
| **Rastreamento** | `https://api.metrito.com` | Eventos de rastreamento e webhooks de transação |
| **Dados**        | `https://api.metrito.com` | Consulta de métricas de anúncios sincronizadas  |

Plataforma, rastreamento e consulta de métricas compartilham o host **`https://api.metrito.com`** (gateway unificado). Não é necessário usar um subdomínio específico para dados.

## Autenticação

A maioria dos endpoints exige autenticação. Veja a [página de autenticação](/api-reference/authentication) para detalhes completos.

**Resumo rápido:**

* **API Key** `mtk_live_...` — recomendado para integrações. Criada em **Configurações → Chaves de API** na plataforma.
* **JWT** — obtido via `POST /v3/auth/login` com e-mail e senha.
* **Públicos** — apenas `POST /v2/public/tracking/events` (modo sem API key) não exige autenticação. `GET /v3/fields` e as demais rotas da API de dados exigem JWT ou API Key.

## Infraestrutura

Toda requisição à API v3 retorna:

* **`X-Request-Id`** — ID único para rastreamento e suporte
* **`X-RateLimit-*`** — Headers de rate limiting ([ver detalhes](/api-reference/rate-limits))
* **Formato de erro padronizado** — Códigos máquina-legíveis em todas as respostas de erro

## APIs

<CardGroup cols={3}>
  <Card title="Plataforma" icon="grid-2" href="/api-reference/autenticar-na-plataforma">
    Login, listagem de projetos e conexões. Ponto de partida para descobrir IDs.
  </Card>

  <Card title="Rastreamento" icon="satellite-dish" href="/api-reference/enviar-evento">
    Envie eventos de rastreamento e webhooks de transação de qualquer plataforma.
  </Card>

  <Card title="Dados" icon="chart-mixed" href="/api-reference/listar-campos-disponíveis">
    Consulte métricas de anúncios com filtros, granularidade temporal e conversão de moeda.
  </Card>
</CardGroup>

## Fluxo Típico de Integração

<Steps>
  <Step title="Autentique-se">
    Crie uma [API Key](/api-reference/authentication) na plataforma ou faça [login](/api-reference/autenticar-na-plataforma) para obter um JWT.
  </Step>

  <Step title="Descubra seus projetos">
    Use `GET /v3/projects` para listar os projetos disponíveis e obter o `project_id`.
  </Step>

  <Step title="Liste as conexões">
    Use `GET /v3/projects/{project_id}/connections` para ver as fontes de dados conectadas.
  </Step>

  <Step title="Consulte campos disponíveis">
    Use `GET /v3/fields` para descobrir quais métricas e dimensões estão disponíveis.
  </Step>

  <Step title="Consulte métricas">
    Use `POST /v3/query` com o `project_id`, campos desejados e período para obter os dados.
  </Step>
</Steps>