POST `/verification/liveness/begin`

Initiate a liveness detection session, returns session token and action sequence (e.g., blink, open mouth, shake head, etc.); detection must be completed before session expiration.

Verification Service `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	Liveness detection session token and action sequence	`dto.DataResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_BeginLivenessResponse`
400	Invalid request parameters	`dto.SimpleResponse`
401	Unauthenticated or invalid token	`dto.SimpleResponse`
500	Internal server error	`dto.SimpleResponse`

Referenced Schemas

dto.DataResponse-gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto_BeginLivenessResponse

Field	Type	Required
`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
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

gitee_com_linmes_authms_micro-services_verification-service_internal_handler_dto.BeginLivenessResponse

Field	Type	Required
`action_sequence`	`string`	No
`expires_at`	`integer`	No
`session_token`	`string`	No

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

POST /verification/liveness/begin