package main; import com.fingerprint.api.FingerprintApi; import com.fingerprint.model.EventsGetResponse; import com.fingerprint.model.EventsUpdateRequest; import com.fingerprint.model.VisitorsGetResponse; import com.fingerprint.sdk.ApiClient; import com.fingerprint.sdk.ApiException; import com.fingerprint.sdk.Configuration; import com.fingerprint.sdk.Region; public class FingerprintApiExample { // Fingerprint Secret API Key private static final String FPJS_API_SECRET = "Fingerprint Secret API Key"; // A mandatory visitorId of a specific visitor private static final String FPJS_VISITOR_ID = "visitorId"; // An optional requestId made by a specific visitor private static final String FPJS_REQUEST_ID = "requestId"; // An optional linkedId of the visit private static final String FPJS_LINKED_ID = "linkedId"; // An optional parameter limiting scanned results private static final Integer LIMIT = 10; // An optional parameter used to paginate results, see lastTimestamp private static final String PAGINATION_KEY = "1683900801733.Ogvu1j"; public static void main(String... args) { // Create a new api client instance from Configuration with your Fingerprint Server API Key and your Fingerprint Server API Region. /*  You can specify a region on getDefaultApiClient function's second parameter  If you leave the second parameter empty, then Region.GLOBAL will be used as a default region  Options for regions are:  Region.GLOBAL  Region.EUROPE  Region.ASIA  */ ApiClient client = Configuration.getDefaultApiClient(FPJS_API_SECRET, Region.EUROPE); FingerprintApi api = new FingerprintApi(client); // Get an event with a given requestId try { // Fetch the event with a given requestId EventsGetResponse response = api.getEvent(FPJS_REQUEST_ID); System.out.println(response.getProducts().toString()); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.getEvent:" + e.getMessage()); } // Search events with custom filters try { // By visitorId SearchEventsResponse response = api.searchEvents(LIMIT, new FingerprintApi.SearchEventsOptionalParams().setVisitorId(FPJS_VISITOR_ID)); // Next page // SearchEventsResponse response = api.searchEvents(LIMIT, new FingerprintApi.SearchEventsOptionalParams().setPaginationKey(response.getPaginationKey()).setVisitorId(FPJS_VISITOR_ID)); // Bad bot // SearchEventsResponse response = api.searchEvents(LIMIT, new FingerprintApi.SearchEventsOptionalParams().setBot("bad")); // Filtered by IP // SearchEventsResponse response = api.searchEvents(LIMIT, new FingerprintApi.SearchEventsOptionalParams().setIpAddress("192.168.0.1/32")); System.out.println(response.getEvents().toString()); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.searchEvents:" + e.getMessage()); } // Update an event with a given requestId try { EventsUpdateRequest request = new EventsUpdateRequest(); request.setLinkedId("myNewLinkedId"); api.updateEvent(FPJS_REQUEST_ID, request); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.updateEvent:" + e.getMessage()); } // Get a specific visitor's all visits try { // Fetch all visits with a given visitorId, with a page limit VisitorsGetResponse response = api.getVisits(FPJS_VISITOR_ID, null, null, LIMIT, null, null); System.out.println(response.getVisits().toString()); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.getVisits:" + e.getMessage()); } // Get a specific visitor's all visits with a linkedId try { // Fetch all visits with a given visitorId, with a page limit, skipping the first visit VisitorsGetResponse response = api.getVisits(FPJS_VISITOR_ID, null, FPJS_LINKED_ID, LIMIT, PAGINATION_KEY, null); System.out.println(response.getVisits().toString()); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.getVisits:" + e.getMessage()); } // Use all the parameters on getVisits try { // Fetch the visitor's all visits with a given requestId and linkedId with a page limit while skipping the first visit VisitorsGetResponse response = api.getVisits(FPJS_VISITOR_ID, FPJS_REQUEST_ID, FPJS_LINKED_ID, LIMIT, PAGINATION_KEY, null); System.out.println(response.getVisits().toString()); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.getVisits:" + e.getMessage()); } // Delete visitor data with a given visitorID try { api.deleteVisitorData(FPJS_VISITOR_ID); } catch (ApiException e) { System.err.println("Exception when calling FingerprintApi.deleteVisitorData:" + e.getMessage()); } } }

package com.fingerprint.example; import com.fingerprint.Sealed; import com.fingerprint.model.EventsGetResponse; import java.util.Base64; public class SealedResults { public static void main(String... args) throws Exception { // Sealed result from the frontend. String SEALED_RESULT = System.getenv("BASE64_SEALED_RESULT"); // Base64 encoded key generated in the dashboard. String SEALED_KEY = System.getenv("BASE64_KEY"); final EventsGetResponse event = Sealed.unsealEventResponse( Base64.getDecoder().decode(SEALED_RESULT), // You can provide more than one key to support key rotation. The SDK will try to decrypt the result with each key. new Sealed.DecryptionKey[]{ new Sealed.DecryptionKey( Base64.getDecoder().decode(SEALED_KEY), Sealed.DecryptionAlgorithm.AES_256_GCM ) } ); // Do something with unsealed response, e.g: send it back to the frontend. } }

import com.fingerprint.sdk.WebhookValidation; @RestController class WebhookController { @PostMapping("/api/webhook") public ResponseEntity<String> webhookHandler(@RequestBody byte[] webhook, @RequestHeader HttpHeaders headers) { final String secret = System.getenv("WEBHOOK_SIGNATURE_SECRET"); if (secret == null || secret.isEmpty()) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Secret key is not configured"); } final String signature = headers.getFirst("fpjs-event-signature"); if (signature == null || signature.isEmpty()) { return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Missing fpjs-event-signature header"); } final boolean isValidSignature = WebhookValidation.isSignatureValid(signature, webhook, secret); if (!isValidSignature) { return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Webhook signature is not valid"); } return ResponseEntity.ok("Webhook received"); } }