Webhooks事件类型
Challenge.StateChange
当挑战状态发生变化时发出。
投递与恢复
Webhook 事件在失败时最多重试 2 次。如果您的服务器错过了事件，请使用保存的挑战 ID 轮询 GET /challenge/get-status。详情请参阅投递、重试与恢复。
父母同意挑战不会过期
父母同意挑战会一直保持待处理状态，直到可信成人批准或拒绝它。仅访问方法（OTP、二维码、邮件链接）会过期，挑战本身不会过期。详情请参阅 挑战过期与基于时间的身份验证。
字段
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
eventType | string | 是 | 始终为 "Challenge.StateChange" |
data | object | 是 | 挑战状态更改数据 |
data.id | string (UUID) | 是 | 挑战 ID |
data.productId | number | 是 | 产品 ID |
data.status | string | 是 | PASS、FAIL、IN_PROGRESS 之一 |
data.type | string | 是 | 挑战类型。以下之一：CHALLENGE_SESSION_UPGRADE, CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE, CHALLENGE_PARENTAL_CONSENT, CHALLENGE_AGE_ATTESTATION, CHALLENGE_CUSTOM, CHALLENGE_BULK_APPROVAL_REQUEST, CHALLENGE_UPDATE_JURISDICTION, CHALLENGE_MATERIAL_CHANGE, CHALLENGE_AGE_GATE_AGE_ASSURANCE, CHALLENGE_PARENT_INVITE |
data.dob | string (YYYY-MM-DD) | 否 | 玩家出生日期；可用时存在 |
data.sessionId | string (UUID) | 否 | 当 status 为 PASS 时存在 |
data.approverEmail | string | 否 | 当可信成人批准了挑战时，在 PASS 事件中存在 |
data.kuid | string | 否 | k-ID 用户 ID；可用时存在 |
示例
{
"eventType": "Challenge.StateChange",
"data": {
"id": "9d6b056e-7d62-4a9e-907a-3d0f6f1d1b9a",
"productId": 11472,
"status": "PASS",
"type": "CHALLENGE_PARENTAL_CONSENT",
"dob": "2011-07-12",
"sessionId": "b6d1a7c2-8f34-4c83-bf0b-3a6d4a2f9d31",
"approverEmail": "parent@example.com",
"kuid": "7a1f2c3d-4e5f-6789-abcd-ef0123456789"
}
}