This document is intended for technical developer who are integrating the T5-LDS for performing liveness detection. It describes the API along with interface and packet structure to be used by the clients communicating with the Tech5 T5-LDS.
The information contained in this document is the proprietary and exclusive property of Tech5 except as otherwise indicated. No part of this document, in whole or in part, may be reproduced, stored, transmitted, or used for design purposes without the prior written permission from Tech5.
The information contained in this document is subject to change without notice. The information in this document is provided for informational purposes only. Tech5 specifically disclaims all warranties, express or limited, including, but not limited, to the implied warranty of merchant-ability and fitness for a particular purpose, except as provided for in a separate software license agreement.
This document may contain information of a sensitive nature. This information should not be given to individuals other than those who are involved in the T5-LDS development or integration.
Contact : email@example.com
Tech5 liveness detection service (LDS) is designed to serve customers who have limitations on using Tech5 Liveness iOS and Android SDK products.
LDS is a REST API based service which takes a photo OR video clip + predefined challenge code as input. The service processes the request to confirm on of the two LD checks defined below.
In the context of the intended uses cases the LDS will serve the following purpose:
=== REQUEST ===
POST /v1/lsd?challenge=ll HTTP/1.1
Content-Type: multipart/form-data; boundary=Asrf456BGe4h
Content-Disposition: form-data; name=“video”
[VIDEO RAW DATA]
=== RESPONSE ===
HTTP 200 OK
“status”: “PASSED” (or FAILED)
“failReason”: “FACE_NOT_FOUND” | “TOO_MANY_FACES” | “TOO_FAST” | “TOO_LONG” | “WRONG_DIRECTION”
“croppedFace”: “BASE64 IMAGE”
//Challenge codes LL - Look Left LR - Look Right LU - Look Up LD - Look Down RL - Roll Left RR - Roll Right
Requirements for the video:
Min number of frames - 5
Max length - 3.5 s
Min resolution: 720 x 576
Supported codecs and containers - ffmpeg lib supported (H.264, H.265, etc.; avi, mpeg4, etc.)
Note: The templates returned in each challenge can be used to make sure the perosn in each challenge is the same you would like to authenticate or enroll