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

