Olaylar

Endpoint POST /api/v1/events

Olay endpoint'i Blipit'in şema v1'inde tek bir JSON olayı alır ve kuyruğa koyar. Her Blipit SDK'sı ve Odoo modülü bunu çağırır. Sentry SDK'ları bunun yerine envelope endpoint'ine POST eder ve aynı biçime çevrilir.

1İstek

Anahtar X-Blipit-Key (public ya da secret) ya da ?key= içinde. Odoo ayrıca X-Blipit-Instance gönderir. Gövde en fazla 256 KB, en fazla 32 seviye iç içe. Zorunlu: event_id (32 küçük harfli hex), timestamp (ISO 8601), platform, sdk {name, version} ve bir message ya da bir exception. İsteğe bağlı: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (hesaplanan gruplamayı değiştiren string dizisi), security (yalnızca secret key).

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

2Yanıtlar

202 {id} kabul edildi. 202 {accepted: false, sampled: true, plan} aylık limit aşıldığında: olay sayıldı, saklanmadı. 400 ayrıntılı şema hatası ya da çok derin iç içe yapı. 401 bilinmeyen anahtar. 403 başka bir örneğe bağlı anahtar, public key ile güvenlik olayı (security_needs_secret_key) ya da planda olmayan güvenlik izleme. 429 hız sınırı aşıldı.

3Sentry SDK'ları

POST /api/<project id>/envelope/ ve eski /api/<project id>/store/, anahtar X-Sentry-Auth ya da ?sentry_key= içinde, gövde gzip, deflate ya da brotli ile en fazla 1 MB (açılmış 4 MB). Anahtar URL'deki projeye ait olmalıdır. Envelope başına en fazla 10 olay öğesi; transaction ve span öğeleri span olur; session, sessions, user_report ve feedback öğeleri release sağlığını ve geri bildirimi besler; replay'ler ve profiller atılır.

Bilmekte fayda var

  • Anahtar başına dakikada 300 istek; span'ler ve loglarla paylaşılır.
  • Aynı event_id'yi iki kez göndermek bir kez saklar.
  • Public key tags.db ayarlayamaz; Odoo kopya tespiti temelinin zehirlenememesi için atılır.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve tam DSN'i app.blipit.io içindeki API anahtarları altındadır.