Referencia de la API
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).
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.