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.
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 und weggesampelt: Das Event wurde gezählt, nicht gespeichert. 202 {accepted: false, dropped: true, plan} über der Überschreitungsgrenze (die Obergrenze bei Free, das Doppelte bei bezahlten Plänen): Bis zum nächsten Monat wird nichts behalten. 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.
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.
- 409, wenn die Daten von einer anderen Plattform kommen als der des Projekts, zum Beispiel {"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"}. Events, Sessions, Logs, OTLP-Traces und -Metriken, Fehlerberichte, Replays und Web Vitals antworten alle so. Abgelehnte Daten werden nicht gespeichert und nicht auf das Kontingent angerechnet. Die Blipit-SDKs schreiben diesen Fehler einmal ins Log und senden für den Rest der Laufzeit nichts mehr. Zur Behebung ein Projekt für diese Plattform anlegen und dessen Schlüssel verwenden.
Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.