Centralized OkayLive

OkayLive is used to perform liveness detection on selfie.

Overview

The Centralized OkayLive API also known as "Liveness Detection" is to make sure that the selfie is taken by a real person. This will greatly increase the security level of Facial Verification in order to help to fight against spoof attacks using fake selfies (e.g. recapturing a selfie from monitor screens, printed paper and etc)

Steps:

1. Users can choose to skip this API if the user has activated the "liveness detection" parameter in the Centralized OkayFace API. Else, the user can proceed by following the steps.

2. Place the JourneyId and the content mentioned in the API method below.

3. After expanding the API method, the user can read the descriptions on each parameter and place the details accordingly following this Example.

4. The API will return a number of values and the user can refer to this page for more details.

5. The average processing time is 2s to 3s.

Please refer to the "Image Requirement" section to get the best result for each API return

API Method

POST https://ekycportaldemo.innov8tif.com/api/ekyc/okaylive

Request Body

Name	Type	Description
imageBest *	object	Selfie photo
journeyId*	string	Retrieve from 'Create JourneyID' API

200 Successfully response to the user

Request Code Block

{
    "status": "success",
    "messageCode": "api.success",
    "probability": 0.9999331,
    "score": 9.612308,
    "quality": 0.6691686
}

400: Bad Request Failed to response to the user

{
    status: "error"
}

500: Internal Server Error Internal Server Error

{
    status:"Internal Server Error"
}

Kindly refer to the page below for the interpretation of the result.

Interpretation of Result and Recommended Threshold

Input Example

Input image as image file

This OkayLive API component only accepts image file as input

Postman Collection

Get the Postman Collection https://api2-ekycportal.innov8tif.com/emas-ekyc-portal/postman-collection