GET /enroll
Performs a biometric enrollment (or training) of the user with the uploaded samples that are associated with the token provided for authorization.
The Biometric Class ID (BCID) of the user to be enrolled is specified by the BWS token and the samples to be enrolled are those that have previously uploaded (see Upload Web API) using the same token that has been used for the authorization of this call.
The 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 switched off), transferred to the enrollment procedure.
Optional, defaults to the setting in the BWS Token. A boolean parameter to explicitly switch on live data detection.
When set to true or when 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 default).
The Enroll Web API returns an EnrollResult object, that contains the flag Success, which indicates, whether the enrollment succeeded or not.
In case that the enrollment failed, an Error is reported:
Successful EnrollResult Sample:
{
"Success": true,
}
Failed EnrollResult Sample:
{
"Success": false,
"Error": "LiveDetectionFailed"
}EnrollResult
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:
EnrollResult object.
private static async Task<bool> EnrollAsync(string bwsToken)
{
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", bwsToken);
using (var response = await client.GetAsync(ENDPOINT + $"enroll"))
{
Console.Write("Enrollment 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/enroll",
type: "GET",
headers: {
"Authorization": "Bearer " + token,
},
}).done(function(data, textStatus, jqXHR) {
if (data.Success) {
console.log('enrollment succeeded');
} else {
console.log('enrollment 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/enroll")
.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("enrollment succeeded");
} else {
System.out.println("enrollment failed: " + json.getString("Error"));
}
}For a complete sample refer to the walkthrough.