Python Server SDK

import fingerprint_server_sdk
from fingerprint_server_sdk import ApiException, ErrorResponse
from fingerprint_server_sdk.configuration import Region

configuration = fingerprint_server_sdk.Configuration(
  api_key="SECRET_API_KEY",
  # region=Region.EU
)
api_instance = fingerprint_server_sdk.FingerprintApi(configuration)

# Search events for a specific visitor
try:
    events = api_instance.search_events(10, visitor_id="VISITOR_ID")
    print(events)
except ApiException as e:
    if e.body is not None:
        error_response = ErrorResponse.from_json(e.body)
        if error_response is not None:
            message = f"API request failed: {error_response.error.code} {error_response.error.message}"
        else:
            message = f"API request failed with unexpected error format: {e}"
    else:
        message = f'Exception when searching events: {e}'
    print(message)

# Get a specific identification event
try:
    event = api_instance.get_event("EVENT_ID")
    print(event)
except ApiException as e:
    if e.body is not None:
        error_response = ErrorResponse.from_json(e.body)
        if error_response is not None:
            message = f"API request failed: {error_response.error.code} {error_response.error.message}"
        else:
            message = f"API request failed with unexpected error format: {e}"
    else:
        message = f'Exception when getting an event: {e}'
    print(message)

import fingerprint_pro_server_api_sdk 
import fingerprint_server_sdk 

configuration = Configuration(api_key="SECRET_API_KEY", region="eu") 
from fingerprint_server_sdk.configuration import Region 
configuration = Configuration(api_key="SECRET_API_KEY", region=Region.EU) 

event = api_instance.get_event("EVENT_ID")
visitor_id = event.products.identification.data.visitor_id 
visitor_id = event.identification.visitor_id 

response = api_instance.get_visits("VISITOR_ID", limit=10) 
response = api_instance.search_events(limit=10, visitor_id="VISITOR_ID") 

from fingerprint_pro_server_api_sdk.rest import ApiException, KnownApiException 
from fingerprint_server_sdk import ApiException, ErrorResponse 

try:
    event = api_instance.get_event("EVENT_ID")
except KnownApiException as e: 
    structured_error = e.structured_error 
    print("Error: %s\n" % structured_error.error) 
except ApiException as e:
    if e.body is not None: 
        error_response = ErrorResponse.from_json(e.body) 
        if error_response is not None: 
            print(f"API request failed: {error_response.error.code} {error_response.error.message}") 
        else: 
            print(f"API request failed with unexpected error format: {e}") 

# Partial example (imports omitted).
def get_event(api_instance, sealed_result_bytes, event_id, keys):
    # `sealed_result_bytes` is the base64-decoded `sealed_result` from the frontend.
    # Try to unseal the payload locally first.
    try:
        return unseal_event_response(sealed_result_bytes, keys)
    except Exception as e:
        # Unsealing or deserialization failed. Fall back to the Server API
        # using the event ID sent alongside the sealed client results.
        print(f"Could not unseal result, falling back to Server API: {e}")
        return api_instance.get_event(event_id)