GET /verify
Performs a one-to-one comparison of the uploaded samples with a stored biometric template in order to verify whether the individual is the person he or she claims to be.
The samples to be verified are those that have previously uploaded (see Upload Web API) using the same token that has been used for the authorization of this call. These samples are fetched from the BWS storage (and removed from the storage, so that they cannot be used for any other purpose), sent to the live data detection procedure and finally, if the liveness detection determined that the given data is live data (or liveness detection is disabled) transferred to the verification procedure. In case that the verification succeeds and auto-enrollment is selected in the token an additional automatic enrollment is invoked using these samples.
Optional, defaults to the setting in the BWS Token. A boolean parameter to explicitly switch on live data detection.
When set to true or if the provided BWS token requires liveness detection the operation typically fails as soon as it
cannot undoubtedly determine that the given data is live data. Note that for liveness detection to work at least two face-
or periocular-samples need to be uploaded.
false.
The Verify Web API returns a VerifyResult object that contains the flag Success, which shows, whether the verification succeeded or not,
i.e. whether the identity of the person has been approved or not. In case that the verification failed (i.e. Success is set to false)
an Error is reported:
Successful VerifyResult Sample:
{
"Success": true,
}
Failed VerifyResult Sample:
{
"Success": false,
"Error": "LiveDetectionFailed"
}VerifyResult object in the body text.
With erroneous codes you typically get a Message field within the body text describing the error. The most commonly returned codes are:
VerifyResult object.
private static async Task<bool> VerifyAsync(string bwsToken)
{
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", bwsToken);
using (var response = await client.GetAsync(ENDPOINT + $"verify"))
{
Console.Write("Verification response... ");
if (response.StatusCode == HttpStatusCode.OK)
{
string result = await response.Content.ReadAsStringAsync();
var json = JObject.Parse(result);
bool success = (bool)json["Success"];
Console.Write("Success: " + success);
if (!success)
{
// read out the error
string error = (string)json["Error"];
Console.WriteLine(" - Error: " + error);
}
return success;
}
Console.WriteLine(response.StatusCode.ToString());
return false;
}
}
}jQuery.ajax({
url: "https://bws.bioid.com/extension/verify",
type: "GET",
headers: {
"Authorization": "Bearer " + token,
},
}).done(function(data, textStatus, jqXHR) {
if (data.Success) {
console.log("verification succeeded");
} else {
console.log("verification failed", data.Error);
}
});See also: method performTask in bws.capture.js, which is part of the BWS unified user interface.
// using OkHttpClient from the OkHttp library
Request request = new Request.Builder()
.url("https://bws.bioid.com/extension/verify")
.addHeader("Authorization", "Bearer " + token)
.build();
OkHttpClient client = new OkHttpClient();
Response response = client.newCall(request).execute();
if (response.code() == 200) {
// using org.json.JSONObject from JSON-java library
JSONObject json = new JSONObject(response.body().string());
if (json.getBoolean("Success")) {
System.out.println("verification succeeded");
} else {
System.out.println("verification failed: " + json.getString("Error"));
}
}For a complete sample refer to the walkthrough.