POST /passivelivedetection
Performs a passive face liveness detection (see Face Liveness Detection) on a single image.
To perform a passive live detection, only one live recorded image is required. The image is sent to the quality-check where, among other things, the face detection is done. If the image is suitable, the passive live-detection is executed.
App-ID
:App-Secret
. To receive the necessary BWS WebAPI access data
(App-ID
and App-Secret
) you have to register your application on the
BWS Portal first. This requires a valid BWS subscription.
state
parameter can be provided which is simply passed through to the BWS log and to the returned object.
The body contains a single image media sample, encoded into a Data-URL using the data URI scheme as described in RFC 2397 (see also at Wikipedia).
This API returns a LiveDetectionResult result object is returned, that primarily contains the flag Success, which indicates, whether the live detection succeeded or not:
Success
JobID
State
Errors
Samples
Errors
EyeCenters
The reported sample-errors typically come from the quality-check, which is performed for each sample (refer to the SOAP Quality Check API for a list of possible error-codes), or from the live detection, that might report additional errors as follows:
In case something goes wrong, an error HTTP status code is returned together with some additional information if available.
The call returns one of the standard HTTP status codes:
Invalid samples have been uploaded or they could not be processed successfully, e.g. no face found, etc. The response body typically has a Message field containing the error code:
Message
and an ExceptionMessage
.