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.

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 ve örneklenip elendiğinde: olay sayıldı, saklanmadı. 202 {accepted: false, dropped: true, plan} aşım tavanının üzerinde (Free'de limit, ücretli planlarda limitin iki katı): gelecek aya kadar hiçbir şey tutulmaz. 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ı.

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.
  • Veriler projenin platformundan farklı bir platformdan geldiğinde 409 döner, örneğin {"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"}. Olaylar, oturumlar, loglar, OTLP iz ve metrikleri, hata raporları, replay'ler ve web vitals aynı şekilde yanıt verir. Reddedilen veriler saklanmaz ve kotaya sayılmaz. Blipit SDK'ları bu hatayı bir kez loglar ve çalışmanın geri kalanında göndermeyi durdurur. Çözmek için o platform için bir proje oluşturun ve onun anahtarını kullanın.

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