API Reference

The client application initiates a liveness detection session by making a request to the backend. The system generates a unique session identifier (sessionId), which is essential for tracking the session. This step ensures that the user is physically present and interacting with the system in real time.

Log in to see full request history

Curl Request

curl --location 'https://staging.cypherface.com/start-liveness-session/' \
--header 'authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjeXBoZXJGYWNlSWQiOiI2Nzg4YTU0Njk3ZmQxNjQzNjA5YWMwNGIiLCJ4QXBpS2V5IjoiMWI4YTIyYjgtNmI2NC00YWJhLTlhNWMtNWFiNGNhOWM5NDQ5IiwiaWF0IjoxNzQwMDYyMTIwLCJleHAiOjE3NDAyMzQ5MjB9.fTmqwMCElXGICO34WyNzNJGYnQoMsxWNkqAVDra7h4A' \
--header 'Content-Type: application/json' \
--header 'Cookie: connect.sid=s%3AyoqwqQtJPuetxSVZLt9_3cikxJ6eSZO-.RDMRaaGKPjP%2F7f6E1pJeiOCPXiu61fEP8J8PwHvgW%2BY' \
--data '{
    "userId":"67b72c82732237217a7e1824"
}'

Liveness Detection Process

To start the liveness detection process, the client application must send a POST request to the endpoint /start-liveness-session/. This request will initiate a new session and return a unique sessionId.

Request

Endpoint: POST /start-liveness-session/

Response

On success, the API will return a JSON response containing the session ID:

{
    "sessionId": "1234567890abcdef"
}
    

Usage

The generated sessionId must be stored and used for subsequent requests related to liveness detection, such as face capture and validation.

Body Params
string
required
Defaults to 6789fb11e94adea011383478
Headers
string
required
Defaults to eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjeXBoZXJGYWNlSWQiOiI2Nzg4YTU0Njk3ZmQxNjQzNjA5YWMwNGIiLCJ4QXBpS2V5IjoiMWI4YTIyYjgtNmI2NC00YWJhLTlhNWMtNWFiNGNhOWM5NDQ5IiwiaWF0IjoxNzM3NTU2Mzk3LCJleHAiOjE3Mzc3MjkxOTd9.ZSDsJ69_NkcHtIgKd2okXh23HjOQBagjEKpS5gM5dgw
Responses

Language
Credentials
:
Click Try It! to start a request and see the response here! Or choose an example:
application/json