The iProov Android API Client is a simple wrapper for the iProov REST API v2 written using Retrofit in Kotlin and Fuel in Kotlin for the HTTP networking and JSON serialization/deserialization using Gson. This thus provides two libraries to choose from, to suit technologies you are used to. We also have an iOS Swift API client available here.
v5 of the iProov SDK removed the built-in functionality to obtain tokens using the SDK. This library therefore provides that missing functionality as a separate library, and also provides additional functionality such as the ability to enrol photos.
The iProov REST API should only ever be called directly from your back-end, however this library is designed to help you with debugging/evaluating the iProov Android SDK, to get up-and-running quickly with a pure on-device demo.
Use of the Android API Client requires providing it with your API secret. You should never embed your API secret within a production app.
You can obtain API credentials by registering on the iProov Portal.
Choose which of the two libraries to use for easy access to the basic iProov API v2.
-
kotlinfuel is built in Kotlin and uses Fuel for network calls
- Maven:
com.iproov.android-api-client:kotlin-fuel:1.3.0 - Limited to SDK 19+
- Maven:
-
kotlinretrofit is built in Kotlin and uses Retrofit for network calls
- Maven
com.iproov.android-api-client:kotlin-retrofit:1.3.0 - Limited to SDK 9+
- Maven
Add to the repositories section to your build.gradle file (example shown is in groovy gradle and for kotlin retrofit library):
repositories {
maven { url 'https://raw.githubusercontent.com/iProov/android/master/maven/' }
}Add the dependencies section to your app build.gradle file:
dependencies {
implementation 'com.iproov.android-api-client:kotlin-retrofit:1.3.0'
}When using any of the Kotlin versions, you will also need to add the coroutines dependencies to your app build.gradle file. These or newer:
dependencies {
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.3.0'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.0'
}Both libraries offer the same functionality:
getToken()- Get an enrol/verify token.enrolPhoto()- Once you have an enrolment token, you can enrol a photo against it.validate()- Validates an existing token.invalidate()- Invalidates an existing token.enrolPhotoAndGetVerifyToken()- A helper function which chains togethergetToken()for the enrolment token,enrolPhoto()to enrol the photo, and thengetToken()for the verify token, which you can then use to launch the SDK.
Example of using iProov API Client together with iProov to get a verify token for an existing user and then launch the iProov SDK to perform the verification:
private val uiSupervisorJob = SupervisorJob()
private val uiScope = CoroutineScope(Dispatchers.Main + uiSupervisorJob)
val apiClient = ApiClientRetrofit(
context = this,
baseUrl = "{{ your base url }}",
logLevel = HttpLoggingInterceptor.Level.BODY,
apiKey = "{{ your API key }}",
secret = "{{ your API secret }}")
uiScope.launch {
try {
val token = withContext(Dispatchers.IO) {
apiClient.getToken(AssuranceType.GENUINE_PRESENCE, ClaimType.VERIFY, userId).token
}
// Pass the token to the iProov SDK
} catch (httpEx: HttpException) {
// Handle exception
}
}The Example App included, written in Kotlin with Coroutines, demonstrates the use with simple text output to both screen and logs.
To run the example you need to include a secrets.json file in the src/main/assets/ directory that looks like this:
{
"base_url": <YOUR_URL>,
"api_key": <YOUR_CLIENT_ID>,
"secret": <YOUR_SECRET>
}
This file SHOULD NOT be added to the repo. It is excluded by gitignore for your own safety.