适用于主机平台和二维码流程的小部件 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。

文档

On this page