更新管辖区域
将既有会话迁移到新的司法管辖区，并按该司法管辖区的规则重新评估。 响应为更新后的会话；如果新的司法管辖区要求玩家尚未取得的监护人批准，则返回一个挑战。
Authorization
api-key In: header
Request Body
application/json
管辖区域更新请求
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/session/update-jurisdiction" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "jurisdiction": "US-CA" }'{ "session": { "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d", "etag": "e889efb9e8a985308e82bed78c5aef7f37f50cf36b7337bf654980d0bab7a574", "status": "ACTIVE", "permissions": [ { "name": "public-profile", "enabled": true, "managedBy": "PLAYER", "verifiedAgeThreshold": 18 } ], "allowances": [ { "name": "string", "type": "numerical", "numericalValue": 0.1 } ], "ageStatus": "DIGITAL_MINOR", "ageCategory": "digital-minor", "dateOfBirth": "2005-04-15", "jurisdiction": "US-CA", "managedBy": "PLAYER", "hasApproverEmail": true, "ageVerification": { "verifiedAge": 18, "platformName": "apple-ios", "declarationType": "confirmed", "verificationId": "a50f4f73-3c0c-4720-a8b3-ec57ccb0aa34", "verifiedAt": "2026-03-14T00:00:00Z", "verifiedDob": "2008-03-15" }, "requiredDataProcessingConsentFor": [ "string" ] }, "challenge": { "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802", "type": "CHALLENGE_PARENTAL_CONSENT", "url": "https://example.com/challenge", "oneTimePassword": "123456", "childLiteAccessEnabled": true, "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d", "jurisdiction": "US-CA", "age": 13, "dateOfBirth": "2005-04-15", "otpExpiresAt": "2022-01-01T00:00:00Z", "materialChange": { "presentedDocuments": [ "string" ], "issuedAt": "2019-08-24T14:15:22Z", "actionedAt": "2019-08-24T14:15:22Z", "acceptanceDeadline": "2019-08-24T14:15:22Z" }, "documents": [ { "id": "privacy-policy", "name": "Privacy Policy", "url": "https://example.com/privacy", "isDataNotice": false } ] }}解除会话与家长的关联 POST
解除先前通过 `/invite-parent` 流程与玩家会话建立的家长关联。 成功后，本次调用会清除会话上由家长设定的所有偏好，并触发 `Session.Unlink` webhook。权限和已有的玩家数据保持不变。 本接口对 `sessionId` 幂等。在关联已被解除后再次调用，会返回 200 及原来的 `unlinkedAt`。
升级会话 POST
将玩家的会话升级为活动会话，并在所申请的权限需要监护人同意时创建挑战。 可通过 `sessionId`、`kuid` 或两者同时来标识会话；同时提供两者会将该用户关联到既有会话。两者都不提供会导致请求无效。 `options` 用于调整本次调用所创建挑战的年龄保证，`materialChange` 用于指定为取得同意而展示的法律文件。设置 `materialChange.acceptanceDeadline` 会使本次升级带有截止时间：系统会向监护人发送批准请求链接，且必须在该时间点之前完成批准。任何位于将来的 UTC 时间戳都会按所提供的值精确生效，没有最短时限也不做取整，因此几分钟后的截止时间就是几分钟后。省略该字段则展示文件且不设截止时间。 当文件发生变化需要重新取得同意时，请设置 `priorChallengeId`。新挑战会取代处于待处理或进行中的挑战，并在其文件基础上追加（仅追加），任何较早的链接都会指向最新的挑战。 返回挑战中的一次性密码会过期。请在准备展示时再调用 `/challenge/generate-otp`，并在挑战进入进行中状态之前定期重新生成。