Eventos

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: o evento foi contado, não armazenado. 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.

3SDKs do Sentry

POST /api/<project id>/envelope/ e o mais antigo /api/<project id>/store/, chave em X-Sentry-Auth ou ?sentry_key=, corpo em gzip, deflate ou brotli de até 1 MB (4 MB descomprimido). A chave deve pertencer ao projeto da URL. Até 10 itens de evento por envelope; itens transaction e span viram spans; itens session, sessions, user_report e feedback alimentam a saúde das releases e o feedback; replays e profiles são descartados.

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.