IDBIO Developer Documentation

import java.net.http.*; import java.net.URI; import java.nio.file.*;
import java.util.UUID;

String b64(String path) throws Exception {
    return java.util.Base64.getEncoder().encodeToString(
        Files.readAllBytes(Path.of(path)));
}
String txnId = UUID.randomUUID().toString().replace("-", "");
String body = """
    {"probe":{"image_data_b64":"%s","image_format":"JPEG",
              "liveness_check":true,
              "lens_focus_distance":0.50,"min_focus_distance":0.10},
     "reference":{"image_data_b64":"%s","image_format":"JPEG",
                  "liveness_check":false},
     "match_threshold":0.75}""".formatted(b64(probePath), b64(refPath));

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://<endpoint>/v1/face/match"))
    .header("X-IDBIO-API-Key", apiKey)
    .header("X-IDBIO-Txn-Id",  txnId)
    .header("Content-Type",    "application/json")
    .timeout(java.time.Duration.ofSeconds(15))
    .POST(HttpRequest.BodyPublishers.ofString(body)).build();
var resp = HttpClient.newHttpClient().send(req,
    HttpResponse.BodyHandlers.ofString());
// resp.body() → JSON envelope (see Response Body below)

#include <curl/curl.h>
#include <nlohmann/json.hpp>
using json = nlohmann::json;

json payload = {
    {"probe", {
        {"image_data_b64",      base64_encode(probe_bytes)},
        {"image_format",        "JPEG"},
        {"liveness_check",      true},
        {"lens_focus_distance", 0.50},
        {"min_focus_distance",  0.10}
    }},
    {"reference", {
        {"image_data_b64", base64_encode(ref_bytes)},
        {"image_format",   "JPEG"},
        {"liveness_check", false}
    }},
    {"match_threshold", 0.75}
};
std::string body  = payload.dump();
std::string txnId = make_uuid_hex();   // unique per request
std::string txnHdr = "X-IDBIO-Txn-Id: " + txnId;

CURL* curl = curl_easy_init();
struct curl_slist* h = nullptr;
h = curl_slist_append(h, "Content-Type: application/json");
h = curl_slist_append(h, "X-IDBIO-API-Key: <api-key>");
h = curl_slist_append(h, txnHdr.c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://<endpoint>/v1/face/match");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, h);
curl_easy_perform(curl);

import java.net.http.*; import java.net.URI; import java.nio.file.*;
import java.util.UUID;

String b64(String path) throws Exception {
    return java.util.Base64.getEncoder().encodeToString(
        Files.readAllBytes(Path.of(path)));
}
String txnId = UUID.randomUUID().toString().replace("-", "");

// Strong mode — two frames at different focus distances
String body = """
{
  "liveness_mode": "strong",
  "frames": [
    {"frame_index":0,"image_data_b64":"%s",
     "liveness_metadata":{"lens_focus_distance":0.50,"min_focus_distance":0.10}},
    {"frame_index":1,"image_data_b64":"%s",
     "liveness_metadata":{"lens_focus_distance":5.00,"min_focus_distance":0.10}}
  ]
}""".formatted(b64(nearPath), b64(farPath));

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://<endpoint>/v1/face/liveness"))
    .header("X-IDBIO-API-Key", apiKey)
    .header("X-IDBIO-Txn-Id",  txnId)
    .header("Content-Type",    "application/json")
    .timeout(java.time.Duration.ofSeconds(15))
    .POST(HttpRequest.BodyPublishers.ofString(body)).build();
var resp = HttpClient.newHttpClient().send(req,
    HttpResponse.BodyHandlers.ofString());

#include <curl/curl.h>
#include <nlohmann/json.hpp>
using json = nlohmann::json;

json payload = {
    {"liveness_mode", "strong"},
    {"frames", json::array({
        {
            {"frame_index",    0},
            {"image_data_b64", base64_encode(near_bytes)},
            {"liveness_metadata", {
                {"lens_focus_distance", 0.50},
                {"min_focus_distance",  0.10}
            }}
        },
        {
            {"frame_index",    1},
            {"image_data_b64", base64_encode(far_bytes)},
            {"liveness_metadata", {
                {"lens_focus_distance", 5.00},
                {"min_focus_distance",  0.10}
            }}
        }
    })}
};
std::string body  = payload.dump();
std::string txnId = make_uuid_hex();   // unique per request
std::string txnHdr = "X-IDBIO-Txn-Id: " + txnId;

CURL* curl = curl_easy_init();
struct curl_slist* h = nullptr;
h = curl_slist_append(h, "Content-Type: application/json");
h = curl_slist_append(h, "X-IDBIO-API-Key: <api-key>");
h = curl_slist_append(h, txnHdr.c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://<endpoint>/v1/face/liveness");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, h);
curl_easy_perform(curl);