Riferimento API
Eventi
Endpoint POST /api/v1/events
L'endpoint degli eventi accetta un evento JSON nello schema v1 di Blipit e lo mette in coda. È ciò che chiamano ogni SDK Blipit e il modulo Odoo.
1Richiesta
Chiave in X-Blipit-Key (pubblica o segreta) o ?key=. Odoo invia anche X-Blipit-Instance. Corpo fino a 256 KB, annidato al massimo 32 livelli. Obbligatori: event_id (32 esadecimali minuscoli), timestamp (ISO 8601), platform, sdk {name, version}, e un message o un'exception. Facoltativi: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (array di stringhe che sostituisce il raggruppamento calcolato), security (solo chiave segreta).
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" }
}'2Risposte
202 {id} accettato. 202 {accepted: false, sampled: true, plan} oltre il limite mensile e scartato dal campionamento: l'evento è stato contato, non salvato. 202 {accepted: false, dropped: true, plan} oltre la soglia di superamento (il limite su Free, il doppio sui piani a pagamento): non si conserva nulla fino al mese successivo. 400 errore di schema con dettaglio, o annidamento troppo profondo. 401 chiave sconosciuta. 403 chiave legata a un'altra istanza, evento di sicurezza con una chiave pubblica (security_needs_secret_key), o monitoraggio della sicurezza non nel piano. 429 limite di frequenza superato.
Buono a sapersi
- 300 richieste al minuto per chiave, condivise con span e log.
- Inviare lo stesso event_id due volte lo salva una sola volta.
- La chiave pubblica non può impostare tags.db; viene scartato così la base di riferimento per il rilevamento delle copie Odoo non può essere avvelenata.
- 409 quando i dati arrivano da una piattaforma diversa da quella del progetto, per esempio {"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"}. Eventi, sessioni, log, trace e metriche OTLP, segnalazioni di bug, replay e web vitals rispondono tutti così. I dati rifiutati non vengono salvati e non contano nella quota. Gli SDK di Blipit registrano questo errore una volta e smettono di inviare per il resto dell'esecuzione. Per risolvere, crea un progetto per quella piattaforma e usa la sua chiave.
Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.