取消家长邀请
在家长完成之前取消进行中的家长邀请挑战。当家长正在验证过程中,而玩家在你的应用内取消了待处理的邀请时使用。 取消后,挑战会带着 `failureReason: "cancelled-by-initiator"` 转为 FAIL,正在查看托管组件的家长会看到「邀请已取消」状态。 此接口只能取消 `CHALLENGE_PARENT_INVITE` 类型的挑战。
Authorization
api-key In: header
Request Body
application/json
Cancel invite request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/challenge/cancel-invite" \ -H "Content-Type: application/json" \ -d '{ "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802" }'{ "cancelled": true}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}升级会话 POST
将玩家的会话升级为活动会话,并在所申请的权限需要监护人同意时创建挑战。 可通过 `sessionId`、`kuid` 或两者同时来标识会话;同时提供两者会将该用户关联到既有会话。两者都不提供会导致请求无效。 `options` 用于调整本次调用所创建挑战的年龄保证,`materialChange` 用于指定为取得同意而展示的法律文件。设置 `materialChange.acceptanceDeadline` 会使本次升级带有截止时间:系统会向监护人发送批准请求链接,且必须在该时间点之前完成批准。任何位于将来的 UTC 时间戳都会按所提供的值精确生效,没有最短时限也不做取整,因此几分钟后的截止时间就是几分钟后。省略该字段则展示文件且不设截止时间。 当文件发生变化需要重新取得同意时,请设置 `priorChallengeId`。新挑战会取代处于待处理或进行中的挑战,并在其文件基础上追加(仅追加),任何较早的链接都会指向最新的挑战。 返回挑战中的一次性密码会过期。请在准备展示时再调用 `/challenge/generate-otp`,并在挑战进入进行中状态之前定期重新生成。
批量创建挑战 POST
为同一位玩家一次性创建多个产品的家长同意挑战,使一次家长交互即可覆盖整个产品系列。 响应中会为每个请求的产品返回一个挑战。与单个挑战一样,挑战通过或失败后,`oneTimePassword` 和 `url` 将被省略。