Skip to content

Liveness Check on Web Service

The Liveness Assessment feature requires either a Mobile client or a Web Component for operation and session data collection. A storage solution for session data is also necessary, refer to the Storage page for detailed information.

Active and Passive Modes

Liveness detection can be performed in two modes: active and passive.

The active mode requires users to turn their head during the session. This guarantees highly accurate liveness detection.

The passive liveness check simply involves taking a selfie. This approach offers improved user experience, however, the accuracy of the liveness detection result will be lower.

Whether to perform passive or active liveness check is determined by the livenessType parameter.

The liveness check status is indicated by the status field, where 0 signifies confirmed liveness and 1 indicates that liveness is not confirmed.

Web API

The results can be obtained via API, see Face SDK OpenAPI.

Result Directory

The liveness check results, a person's selfie and video of the liveness detection session are stored on the backend at:

faceapi-session/year={year}/month={month}/day={day}/hour={hour}/minute={minute}/{tag}/transactionId

Tag

tag is a unique identifier for each session and it is automatically generated by the application. Alternatively, you can specify tag yourself, but in this case make sure that all tags you specify are unique.

Note that for tag only Latin uppercase and lowercase letters, digits, and symbols - and _ are allowed. The maximum supported number of characters is 127.