Comment on page
How to Check Your Media for Liveness without Oz Front End
Oz API is a rich Rest API for facial biometry, where you can do liveness checks and face matching. Oz API features are:
- Persistence: your media and analysis are stored for future reference unless you explicitly delete it,
- Ability to work with videos as well as images,
- Asynchronous analyses,
- Roles and access management.
The unit of work in Oz API is a folder: you can upload interrelated media to a folder, run analyses on them, and check for the aggregated result.
This step-by-step guide describes how to perform a liveness check on a facial image or video that you already have with Oz backend: create a folder, upload your media to this folder, initiate liveness check and poll for the results.
For better accuracy and user experience, we recommend that you use our Web and/or Native SDK on your front end for face capturing. Please refer to the relevant guides:
"email": "<login>", // your admin access email
"password": "<password>" // the password you’ve got from us
Get the access_token from the response and add it to the X-Forensic-Access-Token of all subsequence requests.
This step is not needed for API 5.0.0 and above.
With API 4.0.8 and below, Oz API needs video or archived sequence of images in order to perform liveness check. If you want to analyze a single image, you need to transform it into a ZIP archive. Oz API will treat this archive as a video.
Make sure that you use corresponding video-related tags later on.
In the payload field, set the appropriate tags:
The successful response will return code 201 and the
folder_idyou’ll need later on.
The results will be available in a short while. The method will return analyse_id that you’ll need at the next step.
- get the qualitative result from resolution (
- get the quantitative results from
confidence_spoofingranges from 0.0 (real person) to 1.0 (spoofing).
Here is the Postman collection for this guide.
Oz API Check with No Front End.postman_collection.json
With these steps completed, you are done with Liveness check via Oz API. You will be able to access your media and analysis results in Web UI via browser or programmatically via API.