API 参考
反馈
Endpoint POST /api/v1/feedback
反馈是用户的一条消息,可选地关联到一个事件 id,以便显示在该问题上。
1请求
公钥放在 X-Blipit-Key 或 ?key= 中。请求体:message(1 到 5,000 个字符,必填)、name(最多 128 个)、email(经过验证)、event_id(32 位十六进制,允许连字符)、url(存储时去除查询字符串)。
curl https://in.blipit.io/api/v1/feedback \
-H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
-d '{"message":"Checkout froze after I pressed pay","name":"Ana","email":"ana@example.com","event_id":"9f1c4b6d8e2a47f0b3c5d7e9a1b2c3d4"}'2响应
201 {id}。400 并指出失败的字段。401 未知密钥。
须知
- 每个密钥每分钟 60 个请求。
- 如果事件尚未处理完成,与其问题的关联会稍后建立。
- 201 响应还包含 ref(报告编号,如 BR-12)和 emails(报告者将收到邮件更新时为 true)。可选的 locale(en、ar、es、fr、de、pt、it、nl、tr、zh 或 ja)设置这些邮件的语言;未提供时,Blipit 使用 context.device.language,然后使用工作区语言。
- 当数据来自与项目不同的平台时返回 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 密钥”下。