セッションをアップグレードする
プレイヤーのセッションをアクティブなセッションにアップグレードします。要求された権限に保護者の同意が必要な場合はチャレンジを作成します。 セッションは `sessionId`、`kuid`、またはその両方で指定します。両方を指定すると、そのユーザーを既存のセッションに紐付けます。いずれも指定しない場合は不正なリクエストになります。 `options` はこの呼び出しで作成されるチャレンジの年齢保証を調整し、`materialChange` は同意のために提示する法的文書を指定します。`materialChange.acceptanceDeadline` を設定すると期限付きのアップグレードになります。保護者に承認リクエストのリンクがメールで送られ、その日時までに承認する必要があります。将来のUTCタイムスタンプは指定どおりに扱われ、最小の猶予期間も丸め処理もありません。数分後の期限はそのまま数分後です。省略した場合は期限なしで文書を提示します。 文書が変更されて再同意が必要な場合は `priorChallengeId` を設定してください。新しいチャレンジは保留中または進行中のチャレンジに優先し、その文書に追加されます（追加のみ）。以前のリンクは常に最新のものへ解決されます。 返されたチャレンジのワンタイムパスワードには有効期限があります。表示する直前に `/challenge/generate-otp` を呼び出し、チャレンジが進行中になるまで定期的に再生成してください。
Authorization
api-key In: header
Request Body
application/json
セッションアップグレードリクエスト
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/session/upgrade" \ -H "Content-Type: application/json" \ -d '{ "requestedPermissions": [ { "name": "public-profile" }, { "name": "voice-chat" }, { "name": "online-status" } ] }'{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d", "ageStatus": "LEGAL_ADULT", "ageCategory": "adult", "etag": "e889efb9e8a985308e82bed78c5aef7f37f50cf36b7337bf654980d0bab7a574", "status": "ACTIVE", "dateOfBirth": "2005-04-15", "jurisdiction": "US-CA", "managedBy": "PLAYER", "permissions": [ { "name": "text-chat-public", "enabled": false, "managedBy": "GUARDIAN" }, { "name": "text-chat-private", "enabled": true, "managedBy": "PLAYER" }, { "name": "forums", "enabled": false, "managedBy": "PROHIBITED" } ], "allowances": [ { "name": "3516-7b2e", "numericalValue": 5, "type": "numerical" }, { "name": "63d3-90ac", "selectionValue": "733c-ca11", "type": "selection" } ]}{ "error": "NOT_FOUND", "errorMessage": "Session not found"}管轄区域を更新する POST
既存のセッションを新しい管轄区域に移し、その管轄区域のルールで再評価します。 レスポンスは更新後のセッション、または新しい管轄区域が保護者の承認を必要とし、プレイヤーがまだ承認を得ていない場合はチャレンジです。
保護者への招待をキャンセルする POST
保護者が完了する前に、進行中の保護者招待チャレンジをキャンセルします。保護者が検証中に、プレイヤーがアプリケーション内から保留中の招待をキャンセルした場合に使用します。 キャンセルすると、チャレンジは `failureReason: "cancelled-by-initiator"` を伴って FAIL に遷移し、ホスト型ウィジェットを表示している保護者には「招待がキャンセルされました」の状態が表示されます。 このAPIでキャンセルできるのは `CHALLENGE_PARENT_INVITE` のチャレンジのみです。