Eventos

1Petición

Clave en X-Blipit-Key (pública o secreta) o ?key=. Odoo también envía X-Blipit-Instance. Cuerpo de hasta 256 KB, anidado como máximo 32 niveles. Obligatorio: event_id (32 hexadecimales en minúsculas), timestamp (ISO 8601), platform, sdk {name, version}, y un message o una exception. Opcional: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (array de cadenas que reemplaza la agrupación calculada), security (solo clave 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" }
  }'

2Respuestas

202 {id} aceptado. 202 {accepted: false, sampled: true, plan} por encima del límite mensual: el evento se contó, no se guardó. 400 error de esquema con detalle, o anidamiento demasiado profundo. 401 clave desconocida. 403 clave vinculada a otra instancia, evento de seguridad con clave pública (security_needs_secret_key), o monitorización de seguridad no incluida en el plan. 429 límite de frecuencia.

3SDKs de Sentry

POST /api/<project id>/envelope/ y el antiguo /api/<project id>/store/, clave en X-Sentry-Auth o ?sentry_key=, cuerpo gzip, deflate o brotli de hasta 1 MB (4 MB descomprimido). La clave debe pertenecer al proyecto de la URL. Hasta 10 elementos de evento por envelope; los elementos transaction y span se convierten en spans; los elementos session, sessions, user_report y feedback alimentan la salud de releases y el feedback; los replays y perfiles se descartan.

Conviene saber

• 300 peticiones por minuto y clave, compartidas con spans y logs.
• Enviar el mismo event_id dos veces lo guarda una sola vez.
• La clave pública no puede establecer tags.db; se descarta para que no se pueda envenenar la línea base de detección de copias de Odoo.