事件

Endpoint POST /api/v1/events

事件端点接收一个符合 Blipit schema v1 的 JSON 事件并将其排队。每个 Blipit SDK 和 Odoo 模块调用的都是它。

1请求

密钥放在 X-Blipit-Key(公钥或私密密钥)或 ?key= 中。Odoo 还会发送 X-Blipit-Instance。请求体最大 256 KB,嵌套最多 32 层。必填:event_id(32 位小写十六进制)、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 为上限,付费方案为上限的两倍):直到下个月不再保留任何事件。400 schema 错误(附详情)或嵌套过深。401 未知密钥。403 密钥绑定到其他实例、用公钥发送安全事件(security_needs_secret_key),或套餐不含安全监控。429 限流。

须知

  • 每个密钥每分钟 300 个请求,与 span 和日志共享。
  • 同一个 event_id 发送两次只存储一次。
  • 公钥不能设置 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 密钥”下。