MonitorMix API
v1 · base /api/v1
Operacional · checando...

MonitorMix API v1

REST + JWT + SignalR. Integre Sympla, Eventbrite, bilheterias e CRMs ao monitoramento de audiência presencial.

Base URL
api.monitormix.com.br
Auth
Bearer JWT · X-Api-Key
Rate limit
60 req/min por API key

Autenticação

Dois esquemas. JWT para o dashboard; API Key para integrações externas.

🔐 JWT (usuários do painel)

curl -X POST https://api.monitormix.com.br/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@monitormix.com.br",
    "password": "Admin@123"
  }'

Retorna accessToken (60 min) + refreshToken (14 dias).

🔑 API Key (integrações)

curl https://api.monitormix.com.br/api/v1/integration/me \
  -H "X-Api-Key: mmix_live_xxxxxxxxxxxx"

Gere a key em app.monitormix.com.br/settings/integrations. Scopes granulares por recurso.

Exemplo: Sympla cadastra um show

Workflow real. Sistema externo gera evento → POST automático → sistema MonitorMix mostra na agenda do artista.

# 1. Você tem uma API key com scope shows:write
KEY="mmix_live_a1b2c3d4e5f6..."

# 2. POST de um novo show (idempotente — pode dar retry sem duplicar)
curl -X POST https://api.monitormix.com.br/api/v1/integration/artists/{artistId}/shows \
  -H "X-Api-Key: $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sympla-evt-{eventId}" \
  -d '{
    "scheduledAt": "2026-09-15T22:00:00Z",
    "durationHours": 4,
    "city": "São Paulo",
    "state": "SP",
    "venueName": "Allianz Parque",
    "capacityEstimate": 45000,
    "notes": "Importado do Sympla evt-12345"
  }'

Principais endpoints

Veja todos em /swagger.

Auth
POST /api/v1/auth/login JWT pair
POST /api/v1/auth/refresh renovar access token
GET /api/v1/auth/me user + roles
Público (sem auth, rate-limited)
GET /api/v1/scan/{qrToken} dados do artista pro questionário
POST /api/v1/scan/{qrToken}/response cadastro do fã + sorteio
Artistas
GET /api/v1/artists paginado
GET /api/v1/artists/{id}
PATCH /api/v1/artists/{id}
Shows · Leads · Analytics · Sorteios
GET /api/v1/artists/{artistId}/shows
POST /api/v1/artists/{artistId}/shows
GET /api/v1/artists/{artistId}/leads paginado, com filtros
GET /api/v1/artists/{artistId}/analytics/heatmap cidade × intensidade
POST /api/v1/artists/{artistId}/raffles/draw sortear ganhador
Integration (sistemas externos · X-Api-Key)
GET /api/v1/integration/me
POST /api/v1/integration/artists/{id}/shows idempotente
POST /api/v1/integration/artists/{id}/leads importação massiva
POST /api/v1/integration/artists/{id}/playlist
Real-time (SignalR)
WS /hubs/notifications push de novos leads/sorteios