Eventi

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: l'evento è stato contato, non salvato. 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.

3SDK Sentry

POST /api/<project id>/envelope/ e il più vecchio /api/<project id>/store/, chiave in X-Sentry-Auth o ?sentry_key=, corpo gzip, deflate o brotli fino a 1 MB (4 MB decompresso). La chiave deve appartenere al progetto nell'URL. Fino a 10 elementi evento per envelope; gli elementi transaction e span diventano span; gli elementi session, sessions, user_report e feedback alimentano release health e feedback; replay e profili vengono scartati.

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.