拉起真人认证 H5

POST

/api/ark/v1

拉起端上 H5 真人认证页链接。

终端客户使用 H5Link 完成真人认证，点击“完成”按钮后，将打开 CallbackURL 链接，您可通过解析 CallbackURL 地址后拼接的 resultCode 参数获取真人认证结果。

终端客户通过真人认证（resultCode 为 10000）后，可使用返回的 BytedToken 调用 GetVisualValidateResult 查询对应的 Asset Group ID。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json必填

示例

{
    "CallbackURL": "https://your-domain.example.com/callback",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/ark/v1?Action=CreateVisualValidateSession&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "CallbackURL": "https://your-domain.example.com/callback",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "RequestId": "202405142130005E6F708192031A2B3C",
        "Action": "CreateVisualValidateSession",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "BytedToken": "vvs-20240514212750-c8f2p",
        "H5Link": "https://ark.cn-beijing.volcengine.com/verify/h5?byted_token=vvs-20240514212750-c8f2p&lng=zh",
        "CallbackURL": "https://your-domain.example.com/callback"
    }
}

删除素材组

获取真人