API 参考
会话
Endpoint POST /api/v1/sessions
会话驱动发布页面上的采用率和无崩溃率。可发送单个会话或聚合计数;会话需要 release。
1请求
公钥放在 X-Blipit-Key 或 ?key=(用于 sendBeacon)中。一个 session 对象、最多 100 个的 {sessions: [...]},或 {release, environment?, aggregates: [...]}。一个 session:sid(8 到 64 个字母、数字、连字符)、release(必填)、environment?、status(ok、errored、abnormal、crashed)、errors?(大于 0 的计数表示 errored)、did?(用户 id,只存储哈希前缀)、started?(ISO 或 epoch 秒)。再次发送同一个 sid 会保留最差的状态。
curl "https://in.blipit.io/api/v1/sessions" \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{"sessions":[{"sid":"c1f2a9d4e7b8","did":"user-42","status":"crashed","release":"shop@1.4.2","environment":"production"}]}'2响应
202 {accepted: n}。400 当没有任何项包含 sid 和 release,或超过 100 个会话。401 未知密钥。
须知
- 每个密钥每分钟 3,000 个请求。
- 设置 autoSessionTracking: true 和 release 后,浏览器 SDK 会替你发送这些数据,移动 SDK 也会自动发送。
- 会话保留 90 天。
- 当数据来自与项目不同的平台时返回 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 密钥”下。