API リファレンス
イベント
エンドポイント 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(シークレットキーのみ)。
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キー」にあります。