API-referentie

Events

Endpoint POST /api/v1/events

Het event-endpoint neemt één JSON-event in Blipit's schema v1 en zet het in de wachtrij. Dit is wat elke Blipit SDK en de Odoo-module aanroepen. Sentry SDK's posten in plaats daarvan naar het envelope-endpoint en worden naar dezelfde vorm vertaald.

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

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

2Antwoorden

202 {id} geaccepteerd. 202 {accepted: false, sampled: true, plan} boven de maandlimiet: het event is geteld, niet opgeslagen. 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.

3Sentry SDK's

POST /api/<project id>/envelope/ en het oudere /api/<project id>/store/, sleutel in X-Sentry-Auth of ?sentry_key=, body gzip, deflate of brotli tot 1 MB (4 MB uitgepakt). De sleutel moet bij het project in de URL horen. Maximaal 10 event-items per envelope; transaction- en span-items worden spans; session-, sessions-, user_report- en feedback-items voeden release health en feedback; replays en profielen worden weggegooid.

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.

Kom je er niet uit? Mail support@blipit.io. Sleutels en de exacte DSN van elk project staan onder API-sleutels in app.blipit.io.