Eventos

Endpoint POST /api/v1/events

El endpoint de eventos toma un evento JSON en el esquema v1 de Blipit y lo pone en cola. Es lo que llaman todos los SDKs de Blipit y el módulo de Odoo.

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

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" }
  }'

2Respuestas

202 {id} aceptado. 202 {accepted: false, sampled: true, plan} por encima del límite mensual y muestreado: el evento se contó, no se guardó. 202 {accepted: false, dropped: true, plan} pasado el tope de exceso (el límite en Free, el doble en los planes de pago): no se conserva nada hasta el mes siguiente. 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.

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.
  • 409 cuando los datos vienen de una plataforma distinta a la del proyecto, por ejemplo {"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, sesiones, logs, trazas y métricas OTLP, informes de errores, replays y web vitals responden igual. Los datos rechazados no se guardan ni cuentan para la cuota. Los SDK de Blipit registran este error una vez y dejan de enviar durante el resto de la ejecución. Para solucionarlo, crea un proyecto para esa plataforma y usa su clave.

¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.