イベント

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

イベントエンドポイントは Blipit のスキーマ v1 の JSON イベントを1件受け取り、キューに入れます。すべての Blipit SDK と Odoo モジュールが呼び出すものです。

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} は月間上限超過でサンプリング除外、イベントはカウントされたが保存されていません。202 {accepted: false, dropped: true, plan} は超過上限(Free は上限、有料プランは上限の2倍)を超えた場合で、翌月まで何も保持しません。400 は詳細付きのスキーマエラー、またはネストが深すぎる場合。401 は不明なキー。403 は別のインスタンスに紐付いたキー、公開キーでのセキュリティイベント(security_needs_secret_key)、またはプランにセキュリティ監視が含まれない場合。429 はレート制限。

知っておくと便利

  • キーごとに1分あたり300リクエスト。スパンとログと共有。
  • 同じ event_id を2回送信しても1回だけ保存されます。
  • 公開キーでは tags.db を設定できません。Odoo のコピー検出ベースラインが汚染されないよう破棄されます。
  • データがプロジェクトとは別のプラットフォームから届いたときは 409 を返します。例:{"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"}。イベント、セッション、ログ、OTLP のトレースとメトリクス、バグレポート、リプレイ、Web Vitals はすべてこの応答になります。拒否されたデータは保存されず、クォータにも数えられません。Blipit の SDK はこのエラーを一度だけログに出し、その実行中は送信を止めます。解決するには、そのプラットフォーム用のプロジェクトを作成し、そのキーを使ってください。

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