适用于主机平台和二维码流程的小部件 ID 与小部件状态
端到端和年龄门控小部件现在会返回 widgetId,因此服务器可以获知玩家在另一台设备上完成的流程的结果,例如用手机扫描主机上显示的二维码。在此之前,该结果只能通过 DOM 事件或重定向返回,而主机两者都无法接收。
新增内容
- 小部件 URL 响应中的
widgetId。/widget/generate-e2e-url和/widget/generate-age-gate-url会在url和shortUrl之外返回widgetId。请将其与玩家关联保存。 - 小部件状态端点。
GET /widget/get-status返回单个小部件的结果:PENDING、PASS、IN_CHALLENGE、FAILED、PROHIBITED或EXPIRED。POST /widget/get-status一次最多读取 100 个小部件。小部件一旦报告PASS,就会一直报告PASS。 Challenge.StateChange中的widgetId。 从这些小部件发起的挑战,其 webhook 现在会携带widgetId。
兼容性
所有变更均为新增,现有字段的含义保持不变。如果你从 OpenAPI 规范生成客户端,/widget/generate-e2e-url 和 /widget/generate-age-gate-url 的响应类型现在分别命名为 GenerateE2EUrlResponse 和 GenerateAgeGateUrlResponse,各自在原有结构上新增了 widgetId。
文档
- 在服务器上获取小部件结果:状态、轮询和 webhook。
Challenge.StateChange事件参考