/verification/liveness/begin
发起活体检测会话,返回会话令牌和动作序列(如眨眼、张嘴、摇头等),需在会话过期前完成检测
请求体
Schema: service-verification/internal/handler/dto.BeginLivenessRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
verification_id |
string |
是 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 活体检测会话令牌与动作序列 | dto.DataResponse-service-verification/internal/handler/dto/BeginLivenessResponse |
| 400 | 请求参数错误 | dto.SimpleResponse |
| 401 | 未认证或令牌无效 | dto.SimpleResponse |
| 500 | 服务内部错误 | dto.SimpleResponse |
引用的 Schema
dto.DataResponse-service-verification/internal/handler/dto/BeginLivenessResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-verification/internal/handler/dto.BeginLivenessResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-verification/internal/handler/dto.BeginLivenessResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
action_sequence |
string |
否 | |||
expires_at |
integer |
否 | |||
session_token |
string |
否 |