イベント

エンドポイント POST /api/v1/events

イベントエンドポイントは Blipit のスキーマ v1 の JSON イベントを1件受け取り、キューに入れます。すべての Blipit SDK と Odoo モジュールが呼び出すものです。Sentry SDK は代わりにエンベロープエンドポイントに POST し、同じ形に変換されます。

1リクエスト

キーは X-Blipit-Key(公開またはシークレット)または ?key= で渡します。Odoo は X-Blipit-Instance も送ります。ボディは 256 KB まで、ネストは最大32階層。必須:event_id(32文字の小文字16進)、timestamp(ISO 8601)、platform、sdk {name, version}、そして message または exception。任意:level、release、environment、user {id, email, username}、tags、breadcrumbs、request {method, url, headers}、contexts、fingerprint(計算されたグルーピングを置き換える文字列の配列)、security(シークレットキーのみ)。

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

2レスポンス

202 {id} は受け付け。202 {accepted: false, sampled: true, plan} は月間上限超過で、イベントはカウントされたが保存されていません。400 は詳細付きのスキーマエラー、またはネストが深すぎる場合。401 は不明なキー。403 は別のインスタンスに紐付いたキー、公開キーでのセキュリティイベント(security_needs_secret_key)、またはプランにセキュリティ監視が含まれない場合。429 はレート制限。

3Sentry SDK

POST /api/<project id>/envelope/ と旧来の /api/<project id>/store/。キーは X-Sentry-Auth または ?sentry_key=、ボディは gzip、deflate、brotli で 1 MB まで(展開後 4 MB)。キーは URL のプロジェクトに属している必要があります。エンベロープあたり最大10件のイベントアイテム。transaction と span アイテムはスパンになり、session、sessions、user_report、feedback アイテムはリリースヘルスとフィードバックに反映され、replay と profile は破棄されます。

知っておくと便利

  • キーごとに1分あたり300リクエスト。スパンとログと共有。
  • 同じ event_id を2回送信しても1回だけ保存されます。
  • 公開キーでは tags.db を設定できません。Odoo のコピー検出ベースラインが汚染されないよう破棄されます。

お困りですか?support@blipit.io までメールしてください。各プロジェクトのキーと正確な DSN は app.blipit.io の「APIキー」にあります。