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).

sh
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.