Face Liveness Create Session ID

Request Method :: POST
Description: This API creates a Liveness Detection Session using AWS Rekognition's Face Liveness Detection service. It generates a unique Session ID for liveness verification and securely stores audit images and session data in an Amazon S3 Bucket. Configurations such as audit image limits and S3 prefixes are customizable. This API creates a Liveness Detection Session using AWS Rekognition's Face Liveness Detection service. It generates a unique Session ID for liveness verification and securely stores audit images and session data in an Amazon S3 Bucket. Configurations such as audit image limits and S3 prefixes are customizable.The API requires valid Client Credentials in the request headers for authorization, ensuring secure access. It verifies the associated privileges before initiating the session. Upon success, the API returns a 200 response with the session ID. In case of failure, a 400 response is returned with an error message and developer details.This API is ideal for scenarios like secure user onboarding, identity verification, and authentication processes. It ensures flexibility, security, and ease of integration for applications requiring liveness detection.

Headers

Content-Type: application/JSON
client_id:  To be shared during integration by ISU Team
client_secret:  To be shared during integration by ISU Team

Response Body Parameters

Parameters Parameter description with examples Data type
sessionid Session ID.
E.g. - "5b3cdbd0-95ae-4880-a470-8475bcd7b783"		 String
status Status of the operation.
0 denotes a Successful Request.
-1 denotes an Unsuccessful Request.		 number
code Status of the performed action. string
data Data.  
devMsg The developer message, after the operation. String
message Front-end message displayed after the operation. string

Sample Response Body

SUCCESS:

 

FAILED:

Status Codes and description

Status HTTP Code Description
0 200 Session ID is generated
-1 400 Sorry, Unable to create sessionid.