You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
管理私域素材库
拉起真人认证 H5
复制全文
下载 pdf
拉起真人认证 H5
POST https://ark.cn-beijing.volcengineapi.com/?Action=CreateVisualValidateSession&Version=2024-01-01​
拉起端上 H5 真人认证页链接。​
终端客户使用 H5Link 完成真人认证,点击"完成"按钮后,将打开 CallbackURL 链接,您可通过解析 CallbackURL 地址后拼接的 resultCode 参数,获取真人认证结果。​
终端客户通过真人认证(resultCode 为 10000)后,您可使用 API 返回的 BytedToken 查询该终端客户对应的 Asset Group ID。具体使用方式请参考 拉起端上 H5 活体认证页。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
CallbackURL string 必选 | 回调 URL​
​
ProjectName string 默认值 default | 所属项目​
​
​
响应参数​
BytedToken string | 认证凭证​
​
CallbackURL string | 回调 URL​
​
H5Link string | H5 认证链接​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "CallbackURL": "https://your-domain.example.com/callback",
    "ProjectName": "default"
}
'

Response

{
    "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"
    }
}
最近更新时间:2026.09.04 20:18:00
这个页面对您有帮助吗?
有用
有用
无用
无用