创建真人认证会话

正式环境

https://api.naoshengyun.com

POST

/v1/video/liveness-sessions

创建有效期约 30 分钟的真人认证会话，并返回 H5 认证地址。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "CallbackURL": "https://callback.example",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.naoshengyun.com/v1/video/liveness-sessions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "CallbackURL": "https://callback.example",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

创建成功

Bodyapplication/json

示例

{
    "Result": {
        "BytedToken": "token-1",
        "CallbackURL": "https://callback.example",
        "H5Link": "https://h5.example"
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🔴500InternalError

🔴502BadGateway

修改于 2026-10-08 05:51:42

Codex

获取真人认证结果