Manual integration

v3.0

Understanding the flow

SDK's headers must be included in your URL requests. To your delight, the SDK automatically intercepts URL requests from your app which sent with OkHttp client. By doing so, the SDK takes care of adding those headers to your URL requests and handling blocks response from your server, which means you don't have to do anything else.

However, you may choose to take care of them manually.

Adding SDK's HTTP headers to your URL requests

1. Disable requests interception by setting the PXPolicy/urlRequestInterceptionType to PXPolicyUrlRequestInterceptionType/none.
   Kotlin Java

   policy.urlRequestInterceptionType = PXPolicyUrlRequestInterceptionType.NONE

   policy.setUrlRequestInterceptionType(PXPolicyUrlRequestInterceptionType.NONE);

2. Before sending your URL request, take HTTP headers from the SDK and add them to your request.
   Kotlin Java

   val headers = PerimeterX.headersForURLRequest(null)
   // add those headers to your URL request

   HashMap<String, String> headers = PerimeterX.INSTANCE.headersForURLRequest(null);
   // add those headers to your URL request

Handle block responses from your server

After receiving an error in the server's response, pass the information to SDK with the PerimeterX/handleResponse(response:data:forAppId:callback:) function.

val isHandledBySDK = PerimeterX.handleResponse(responseString, null) { result ->
    println("challenge result = $result")
}

boolean isHandledByPX = PerimeterX.INSTANCE.handleResponse(responseString, null, result -> {
    Log.i("tag", "challenge result = " + result);
    return null;
);
if (isHandledByPX) {  
    Log.i("tag", "block response was handled by PX");
}