Événements

1Requête

Clé dans X-Blipit-Key (publique ou secrète) ou ?key=. Odoo envoie aussi X-Blipit-Instance. Corps jusqu'à 256 Ko, imbriqué sur au plus 32 niveaux. Requis : event_id (32 hexadécimaux minuscules), timestamp (ISO 8601), platform, sdk {name, version}, et un message ou une exception. Facultatif : level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (tableau de chaînes qui remplace le regroupement calculé), security (clé secrète uniquement).

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

2Réponses

202 {id} accepté. 202 {accepted: false, sampled: true, plan} au-delà du plafond mensuel : l'événement a été compté, pas stocké. 400 erreur de schéma avec détail, ou imbrication trop profonde. 401 clé inconnue. 403 clé liée à une autre instance, événement de sécurité avec une clé publique (security_needs_secret_key), ou surveillance de sécurité absente du plan. 429 limite de débit atteinte.

3SDK Sentry

POST /api/<project id>/envelope/ et l'ancien /api/<project id>/store/, clé dans X-Sentry-Auth ou ?sentry_key=, corps gzip, deflate ou brotli jusqu'à 1 Mo (4 Mo décompressé). La clé doit appartenir au projet de l'URL. Jusqu'à 10 éléments event par enveloppe ; les éléments transaction et span deviennent des spans ; les éléments session, sessions, user_report et feedback alimentent la santé des releases et les retours ; les replays et profils sont écartés.

Bon à savoir

• 300 requêtes par minute et par clé, partagées avec les spans et les logs.
• Envoyer deux fois le même event_id ne le stocke qu'une fois.
• La clé publique ne peut pas définir tags.db ; il est écarté pour que la référence de détection de copie Odoo ne puisse pas être empoisonnée.