API-referentie
Events
Endpoint POST /api/v1/events
Het event-endpoint neemt één JSON-event in schema v1 van Blipit aan en zet het in de wachtrij. Elke Blipit SDK en de Odoo-module roepen dit aan.
1Request
Sleutel in X-Blipit-Key (publiek of geheim) of ?key=. Odoo stuurt ook X-Blipit-Instance. Body tot 256 KB, maximaal 32 niveaus genest. Verplicht: event_id (32 hex-tekens in kleine letters), timestamp (ISO 8601), platform, sdk {name, version}, en een message of een exception. Optioneel: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (array van strings die de berekende groepering vervangt), security (alleen geheime sleutel).
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" }
}'2Antwoorden
202 {id} geaccepteerd. 202 {accepted: false, sampled: true, plan} boven de maandlimiet en weggesampled: het event is geteld, niet opgeslagen. 202 {accepted: false, dropped: true, plan} boven het overschrijdingsplafond (de limiet bij Free, twee keer de limiet bij betaalde plannen): tot volgende maand wordt niets bewaard. 400 schemafout met detail, of te diep genest. 401 onbekende sleutel. 403 sleutel gebonden aan een andere instantie, beveiligingsevent met een publieke sleutel (security_needs_secret_key), of beveiligingsmonitoring niet in het plan. 429 rate limited.
Goed om te weten
- 300 requests per minuut per sleutel, gedeeld met spans en logs.
- Dezelfde event_id twee keer versturen slaat hem één keer op.
- De publieke sleutel kan tags.db niet instellen; die wordt weggegooid, zodat de basislijn voor Odoo-kopiedetectie niet kan worden vervuild.
- 409 als de gegevens van een ander platform komen dan dat van het project, bijvoorbeeld {"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, sessies, logs, OTLP-traces en -metrics, bugmeldingen, replays en web vitals antwoorden allemaal zo. Geweigerde gegevens worden niet opgeslagen en tellen niet mee voor het quotum. De Blipit-SDK's loggen deze fout één keer en sturen de rest van de run niets meer. Los het op door een project voor dat platform aan te maken en de sleutel daarvan te gebruiken.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.