Docs
Status
Supportk-id.comCompliance Studio
Endpoints年龄验证

执行访问年龄验证

发起访问年龄验证并返回用于在 iframe 中展示的托管 URL。用于依据已验证的年龄限制进入某个产品或功能，而不是升级现有会话。 玩家在返回的 URL 上完成验证；请通过 `/age-verification/get-status` 或 webhook 获取结果。

POST
/age-verification/perform-access-age-verification

Authorization

api-key
AuthorizationBearer <token>

In: header

Request Body

application/json

Perform access age verification

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/age-verification/perform-access-age-verification" \  -H "Content-Type: application/json" \  -d '{    "jurisdiction": "US-CA",    "criteria": {}  }'
{  "id": "12345678-1234-1234-1234-123456789012",  "url": "https://example.com/verify",  "shortUrl": "https://example.com/s/12345678-1234-1234-1234-123456789012?pid=42&s=qr"}

获取年龄验证请求的状态 GET

返回年龄验证请求的当前状态。可在发起验证后轮询，也可用于在服务端确认 webhook。 请求会从 `PENDING` 进入 `IN_PROGRESS`，最终确定为 `PASS` 或 `FAIL`。已确定的请求还会包含验证结果——年龄估计、年龄分类和所用方法——失败时则包含原因。除 `PASS` 和 `FAIL` 之外的状态都应视为仍在进行中。

执行年龄申诉 POST

发起年龄申诉，让未通过年龄检查的玩家能以其他方式证明年龄，并返回用于在 iframe 中展示的托管 URL。 玩家在返回的 URL 上完成申诉；请通过 `/age-verification/get-status` 或 webhook 获取结果。