net.gini.android.capture.network

Interface GiniCaptureNetworkService

All Known Implementing Classes:

GiniCaptureDefaultNetworkService

public interface GiniCaptureNetworkService

Interface specifying network related tasks required by the Gini Capture SDK in order to communicate with the Gini API.

The easiest way to get started is to use the Gini Capture Network Library package which provides a default implementation.

You can also create your own implementation and communicate directly with the Gini API or pass requests through your backend. For direct communication with the Gini API we recommend using the Gini Pay API lib.

In order for the Gini Capture SDK to use your implementation pass an instance of it to GiniCapture.Builder#setGiniCaptureNetworkService(GiniCaptureNetworkService) when creating a GiniCapture instance.

When an instance of this interface is available document analysis related methods in the CameraFragmentListener, ReviewFragmentListener and the AnalysisFragmentListener won't be invoked. Otherwise the Gini Capture SDK falls back to invoking those methods.

Method Summary

Modifier and Type	Method and Description
CancellationToken	analyze(java.util.LinkedHashMap giniApiDocumentIdRotationMap, GiniCaptureNetworkCallback callback) Called when a document needs to be analyzed by the Gini API.
void	cleanup() Called when the Gini Capture SDK is not needed anymore and the GiniCapture#cleanup(Context) method has been called.
CancellationToken	delete(java.lang.String giniApiDocumentId, GiniCaptureNetworkCallback callback) Called when a document needs to be deleted from the Gini API.
default void	handleErrorLog(ErrorLog errorLog)
CancellationToken	upload(Document document, GiniCaptureNetworkCallback callback) Called when a document needs to be uploaded to the Gini API.

Method Detail

upload

CancellationToken upload(Document document,
                         GiniCaptureNetworkCallback callback)

Called when a document needs to be uploaded to the Gini API.

You should only upload the document. Polling or retrieving extractions is not needed at this point.

Parameters:

document - a Document containing an image, pdf or other supported formats

callback - a callback implementation to return the outcome of the upload

Returns:

a CancellationToken to be used for requesting upload cancellation

delete

CancellationToken delete(java.lang.String giniApiDocumentId,
                         GiniCaptureNetworkCallback callback)

Called when a document needs to be deleted from the Gini API.

Parameters:

giniApiDocumentId - id of the document received when it was uploaded to the Gini API

callback - a callback implementation to return the outcome of the deletion

Returns:

a CancellationToken to be used for requesting cancellation of the deletion

analyze

CancellationToken analyze(java.util.LinkedHashMap giniApiDocumentIdRotationMap,
                          GiniCaptureNetworkCallback callback)

Called when a document needs to be analyzed by the Gini API.

The documents were already uploaded and only the Gini API document ids of documents are passed in along with the user applied document rotations.

Parameters:

giniApiDocumentIdRotationMap - a map of Gini API document ids and the user applied document rotations

callback - a callback implementation to return the outcome of the analysis

Returns:

a CancellationToken to be used for requesting analysis cancellation

cleanup

void cleanup()

Called when the Gini Capture SDK is not needed anymore and the GiniCapture#cleanup(Context) method has been called.

Free up any resources your implementation is using.

handleErrorLog

default void handleErrorLog(ErrorLog errorLog)