Referência da API
REST. JSON. Sem ginástica.
A API da camada é o que você espera de uma API REST moderna: payloads JSON, autenticação por header, multi-tenant por design. Em produção desde 2025. Aqui em baixo, os endpoints principais.
Endpoints principais.
POST/eventsIngestão de qualquer evento do tenant. Normalização automática (dot → underscore), validação, persistência em DDB + Firehose.
POST/metrics/ingestEnvio de métricas agregadas (counters, gauges). Atualiza KPIs em tempo real.
POST/assistantConsulta conversacional com dados reais do tenant. RAG + LLM com contexto multi-tenant.
GET/people/profilesLista perfis ativos. Filtros por segmento, recência, churn risk, CLV.
GET/people/profiles/:id/insightsInsight individual: histórico, predições, próxima melhor ação.
GET/kpisKPIs do tenant. Reset diário automático. Filtros por janela temporal.
POST/rulesCriar regra. Schema: condição + ação + janela + canal.
Autenticação.
Três modos de autenticação dependendo do contexto.
X-SYNQ-TOKEN
SDK JavaScript público (browser)
Authorization: Bearer
JWT do Cognito (app autenticado)
X-API-KEY
Servidor-a-servidor (backend integration)
Exemplo: enviar evento.
POST https://api.synqi3.ai/events
Header: X-API-KEY: <sua-chave>
Content-Type: application/json
{
"type": "order_paid",
"user_id": "u_8421",
"amount_total": 234.50,
"channel": "store_app",
"ts": "2026-06-01T20:47:00Z"
}Resposta: 200 OK · evento entra na fila de regras assíncrona.