Android SDK

import com.fingerprintjs.android.fpjs_pro.Configuration
import com.fingerprintjs.android.fpjs_pro.FingerprintJSFactory
...

// Initialize and configure the SDK
val factory = FingerprintJSFactory(applicationContext)
val configuration = Configuration(
  apiKey = "<<browserToken>>",
  // The 'region' must match the region associated with your API key
  region = Configuration.Region.US,
  // For custom subdomain or proxy integration, use this option to specify a custom endpoint.
  // If you do not have a custom endpoint, this parameter can be skipped.
  endpointUrl = "custom-endpoint-URL",
  // Additionally, you may also specify alternate, fallback endpoints to redirect failed
  // requests.
  fallbackEndpointUrls = listOf(
      "fallback-endpoint-URL-1",
      "fallback-endpoint-URL-2",
  ),
  extendedResponseFormat = false
)
 
val fpjsClient = factory.createInstance(
  configuration
)

// Get a 'visitorId'
fpjsClient.getVisitorId { visitorIdResponse ->
  val visitorId = visitorIdResponse.visitorId
  // Use the visitorId
}

import com.fingerprintjs.android.fpjs_pro.Configuration;
import com.fingerprintjs.android.fpjs_pro.FingerprintJS;
import com.fingerprintjs.android.fpjs_pro.FingerprintJSFactory;
import java.util.Arrays;
...

// Initialize and configure the SDK
FingerprintJSFactory factory = new FingerprintJSFactory(this.getApplicationContext());
Configuration configuration = new Configuration(
  "<<browserToken>>",
  // The 'region' must match the region associated with your API key
  Configuration.Region.US,
  // For custom subdomain or proxy integration, use this option to specify a custom endpoint.
  // If you do not have a custom endpoint, this parameter can be skipped.
  "custom-endpoint-URL",
  // Additionally, you may also specify alternate, fallback endpoints to redirect failed
  // requests.
  Arrays.asList(
    "fallback-endpoint-URL-1",
    "fallback-endpoint-URL-2"
  ),
  false
);

FingerprintJS fpjsClient = factory.createInstance(configuration);

// Get a 'visitorId'
fpjsClient.getVisitorId(visitorIdResponse -> {
  // Use the ID
  String visitorId = visitorIdResponse.getVisitorId();
  return null;
});

fpjsClient.getVisitorId (
  // Set a timeout value of 10 seconds
  timeoutMillis = 10_000,
  
  // Get a 'visitorId', will timeout after 10s
  listener = { visitorIdResponse ->
    visitorId = visitorIdResponse.visitorId;
  }
)

fpjsClient.getVisitorId(
  // Pass a timeout value of 10 seconds
  10000,
  visitorIdResponse -> {
    // Get a 'visitorId', will timeout after 10s
    visitorId = visitorIdResponse.getVisitorId();
    return null;
  }
);

fpjsClient.getVisitorId (
  // Associate additional metadata to this request
  tags = mapOf("orderID" to orderId, "zip" to zipCode),
  // Associate an account number to this request 
  linkedId = accountID,
  
  // Get a 'visitorId'
  listener = { visitorIdResponse ->
    visitorId = visitorIdResponse.visitorId;
  }
)   

Map<String, String> tags = new HashMap<>();
tags.put("orderID", orderId);
tags.put("zip", zipCode);

fpjsClient.getVisitorId(
  // Associate additional metadata to this request
  tags,
  // Associate an account number to this request
  accountId,
  // Get a 'visitorId'
  visitorIdResponse -> {
    // handle visitorId and other data
  },
);

fpjsClient.getVisitorId (
  // Get a 'visitorId'
  listener = { visitorIdResponse ->
    visitorId = visitorIdResponse.visitorId;
  },
  errorListener = { error ->
    when(error) {
      is ApiKeyRequired -> {
        val requestId = error.requestId
        // Handle error
      }
    }
  }
)

Map<String, String> tags = new HashMap<>();
tags.put("orderID", orderId);
tags.put("zip", zipCode);

fpjsClient.getVisitorId(
  // Associate additional metadata to this request
  tags,
  // Associate an account number to this request
  accountID,
  // Get a 'visitorId'
  visitorIdResponse -> {
    // Handle visitorId and other data
    String visitorId = visitorIdResponse.getVisitorId();
  	return null;
  },
  // Handle errors
  error -> {
    // Handle errors as per their type 
    if (error.getClass() == ApiKeyRequired.class) {
      Log.e(TAG, error.getRequestId() + error.getDescription());
  	}
  	return null;
  }
);

data class ConfidenceScore(
  val score: Double
)

class Configuration @JvmOverloads constructor(
  val apiToken: String,
  val region: Region = Region.US,
  val endpointUrl: String = region.endpointUrl,
  val fallbackEndpointUrls: List<String> = emptyList(),
  val extendedResponseFormat: Boolean = false
)

sealed class Error(
  // The request ID of the identification request
  val requestId: String = UNKNOWN,
  // A self-explanatory description of the error
  val description: String? = UNKNOWN
)

data class IpLocation(
  val accuracyRadius: Int,
  val latitude: Double,
  val longitude: Double,
  val postalCode: String,
  val timezone: String,
  val city: City,
  val country: Country,
  val continent: Continent,
  val subdivisions: List<Subdivisions>
) {
  data class City(
    val name: String
  )
  data class Country(
    val code: String,
    val name: String
  )
  data class Continent(
    val code: String,
    val name: String
  )
  data class Subdivisions(
    val isoCode: String,
    val name: String
  )
}

public enum class Region(public val endpointUrl: String) {
  US("https://api.fpjs.io"),
  EU("https://eu.api.fpjs.io"),
  AP("https://ap.api.fpjs.io")
}

data class Timestamp(
  val global: String,
  val subscription: String
}