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

