Événements

Endpoint POST /api/v1/events

L'endpoint d'événements prend un événement JSON dans le schéma v1 de Blipit et le met en file d'attente. C'est ce qu'appellent chaque SDK Blipit et le module Odoo.

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

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

2Réponses

202 {id} accepté. 202 {accepted: false, sampled: true, plan} au-delà du plafond mensuel et écarté par échantillonnage : l'événement a été compté, pas stocké. 202 {accepted: false, dropped: true, plan} au-delà du seuil de dépassement (le plafond sur Free, le double sur les offres payantes) : rien n'est conservé jusqu'au mois suivant. 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.

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.
  • 409 quand les données viennent d'une autre plateforme que celle du projet, par exemple {"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"}. Les événements, sessions, logs, traces et métriques OTLP, rapports de bug, replays et web vitals répondent tous ainsi. Les données refusées ne sont pas enregistrées et ne comptent pas dans le quota. Les SDK Blipit écrivent cette erreur une fois dans les logs et n'envoient plus rien pendant le reste de l'exécution. Pour corriger, créez un projet pour cette plateforme et utilisez sa clé.

Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.