Referência da API
Eventos
Endpoint POST /api/v1/events
O endpoint de eventos recebe um evento JSON no schema v1 do Blipit e o enfileira. É o que todo SDK do Blipit e o módulo Odoo chamam.
1Requisição
Chave em X-Blipit-Key (pública ou secreta) ou ?key=. O Odoo também envia X-Blipit-Instance. Corpo de até 256 KB, aninhado em no máximo 32 níveis. Obrigatórios: event_id (32 hexadecimais minúsculos), timestamp (ISO 8601), platform, sdk {name, version} e uma message ou uma exception. Opcionais: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (array de strings que substitui o agrupamento calculado), security (somente chave secreta).
curl https://in.blipit.io/api/v1/events \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{
"event_id": "0123456789abcdef0123456789abcdef",
"timestamp": "2026-09-28T09:15:00Z",
"platform": "python",
"level": "error",
"release": "shop@1.4.2",
"environment": "production",
"exception": {
"type": "KeyError",
"value": "customer_id",
"stacktrace": { "frames": [{ "filename": "shop/cart.py", "function": "checkout", "lineno": 42, "in_app": true }] }
},
"tags": { "company_id": "1" },
"sdk": { "name": "my-sdk", "version": "1.0.0" }
}'2Respostas
202 {id} aceito. 202 {accepted: false, sampled: true, plan} acima do teto mensal e descartado pela amostragem: o evento foi contado, não armazenado. 202 {accepted: false, dropped: true, plan} acima do limite de excedente (o teto no Free, o dobro nos planos pagos): nada é mantido até o mês seguinte. 400 erro de schema com detalhe, ou aninhamento profundo demais. 401 chave desconhecida. 403 chave vinculada a outra instância, evento de segurança com chave pública (security_needs_secret_key) ou monitoramento de segurança fora do plano. 429 limite de taxa.
Bom saber
- 300 requisições por minuto por chave, compartilhadas com spans e logs.
- Enviar o mesmo event_id duas vezes armazena uma vez.
- A chave pública não pode definir tags.db; ela é descartada para que a linha de base de detecção de cópias do Odoo não possa ser contaminada.
- 409 quando os dados vêm de uma plataforma diferente da do projeto, por exemplo {"error": "This project is for iOS. Create a separate Android project in Blipit and use its key.", "reason": "platform_mismatch", "project_platform": "ios", "sent_platform": "android"}. Eventos, sessões, logs, traces e métricas OTLP, relatórios de erros, replays e web vitals respondem todos assim. Os dados recusados não são guardados nem contam para a quota. Os SDKs do Blipit registam este erro uma vez e deixam de enviar durante o resto da execução. Para resolver, crie um projeto para essa plataforma e use a chave dele.
Travou? Envie um e-mail para support@blipit.io. As chaves e o id de cada projeto ficam em Chaves de API no app.blipit.io.