O Metrito expõe três APIs com finalidades distintas: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.
| 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 |
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/logincom e-mail e senha. - Públicos — apenas
POST /v2/public/tracking/events(modo sem API key) não exige autenticação.GET /v3/fieldse 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 suporteX-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
Descubra seus projetos
Use
GET /v3/projects para listar os projetos disponíveis e obter o project_id.Liste as conexões
Use
GET /v3/projects/{project_id}/connections para ver as fontes de dados conectadas.Consulte campos disponíveis
Use
GET /v3/fields para descobrir quais métricas e dimensões estão disponíveis.