POST `/verification/liveness/begin`

发起活体检测会话，返回会话令牌和动作序列（如眨眼、张嘴、摇头等），需在会话过期前完成检测

验证服务 `bearerAuth` application/json

Request Body

Schema: gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.BeginLivenessRequest

Field	Type	Required	Example	Constraints	Description
`verification_id`	`string`	Yes

Responses

Status	Description	Schema
200	活体检测会话令牌与动作序列	`dto.DataResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_BeginLivenessResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

Referenced Schemas

dto.DataResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_BeginLivenessResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`data`	`gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.BeginLivenessResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.BeginLivenessResponse

Field	Type	Required	Example	Constraints	Description
`action_sequence`	`string`	No
`expires_at`	`integer`	No
`session_token`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑