Events

Endpoint POST /api/v1/events

Der Event-Endpoint nimmt ein JSON-Event im Blipit-Schema v1 entgegen und stellt es in die Warteschlange. Ihn rufen jedes Blipit-SDK und das Odoo-Modul auf. Sentry-SDKs senden stattdessen an den Envelope-Endpoint und werden in dieselbe Form übersetzt.

1Request

Schlüssel in X-Blipit-Key (öffentlich oder geheim) oder ?key=. Odoo sendet außerdem X-Blipit-Instance. Body bis 256 KB, höchstens 32 Ebenen verschachtelt. Erforderlich: event_id (32 Hex-Zeichen in Kleinbuchstaben), timestamp (ISO 8601), platform, sdk {name, version} und eine message oder eine exception. Optional: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (Array von Strings, das die berechnete Gruppierung ersetzt), security (nur geheimer Schlüssel).

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

2Antworten

202 {id} angenommen. 202 {accepted: false, sampled: true, plan} über der monatlichen Obergrenze: Das Event wurde gezählt, nicht gespeichert. 400 Schemafehler mit Detail oder zu tiefe Verschachtelung. 401 unbekannter Schlüssel. 403 Schlüssel an eine andere Instanz gebunden, Sicherheitsereignis mit öffentlichem Schlüssel (security_needs_secret_key) oder Sicherheitsüberwachung nicht im Plan. 429 ratenbegrenzt.

3Sentry-SDKs

POST /api/<project id>/envelope/ und das ältere /api/<project id>/store/, Schlüssel in X-Sentry-Auth oder ?sentry_key=, Body gzip, deflate oder brotli bis 1 MB (4 MB entpackt). Der Schlüssel muss zum Projekt in der URL gehören. Bis zu 10 Event-Items pro Envelope; transaction- und span-Items werden zu Spans; session-, sessions-, user_report- und feedback-Items speisen Release Health und Feedback; Replays und Profile werden verworfen.

Gut zu wissen

  • 300 Requests pro Minute und Schlüssel, geteilt mit Spans und Logs.
  • Dieselbe event_id zweimal zu senden speichert sie einmal.
  • Der öffentliche Schlüssel kann tags.db nicht setzen; es wird verworfen, damit die Basis der Odoo-Kopieerkennung nicht vergiftet werden kann.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.