Skip to main content
O Metrito expõe três APIs com finalidades distintas: 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 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)
  • Formato de erro padronizado — Códigos máquina-legíveis em todas as respostas de erro

​
APIs

Plataforma

Login, listagem de projetos e conexões. Ponto de partida para descobrir IDs.

Rastreamento

Envie eventos de rastreamento e webhooks de transação de qualquer plataforma.

Dados

Consulte métricas de anúncios com filtros, granularidade temporal e conversão de moeda.

​
Fluxo Típico de Integração

1

Autentique-se

Crie uma API Key na plataforma ou faça login para obter um JWT.
2

Descubra seus projetos

Use GET /v3/projects para listar os projetos disponíveis e obter o project_id.
3

Liste as conexões

Use GET /v3/projects/{project_id}/connections para ver as fontes de dados conectadas.
4

Consulte campos disponíveis

Use GET /v3/fields para descobrir quais métricas e dimensões estão disponíveis.
5

Consulte métricas

Use POST /v3/query com o project_id, campos desejados e período para obter os dados.