HTTP module

Building an HttpClient

Minimal

HttpClient client = new HttpClientImpl.Builder()
        .setConnectionTimeout(15_000)
        .setReadTimeout(15_000)
        .build();

With HttpClientConfiguration (preferred)

HttpClientConfiguration config = HttpClientConfiguration.builder()
        .connectionTimeout(15_000)
        .readTimeout(15_000)
        .proxy(proxy)                                       // optional
        .proxyAuthenticator(authenticator)                   // optional
        .certificatePinningConfiguration(pinConfig)          // optional
        .developmentSslConfig(devSsl)                        // optional
        .build();

HttpClient client = new HttpClientImpl.Builder()
        .setConfiguration(config)
        .setTlsUpdater(tlsUpdater)  // optional – TlsUpdater
        .build();

Proxy

// Basic auth proxy
HttpProxy proxy = HttpProxy.newBuilder("proxy.example.com", 8080)
        .basicAuth("user", "pass")
        .build();

// mTLS proxy with custom CA
HttpProxy mtlsProxy = HttpProxy.newBuilder("proxy.example.com", 8443)
        .proxyCacert(caCertInputStream)
        .mtls(clientCertInputStream, clientKeyInputStream)
        .build();

// With a credentials provider (e.g. bearer token)
HttpProxy bearerProxy = HttpProxy.newBuilder("proxy.example.com", 8080)
        .credentialsProvider(new BearerCredentialsProvider(tokenSupplier))
        .build();

Certificate pinning

CertificatePinningConfiguration pinConfig = CertificatePinningConfiguration.builder()
        .addPin("sdk.split.io", "sha256/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=")
        .addPin("*.split.io", certInputStream)   // derive pins from a certificate file
        .failureListener(failedHost -> {
            Log.w("Split", "Certificate pinning failed for " + failedHost);
        })
        .build();

Development SSL overrides

DevelopmentSslConfig devSsl = new DevelopmentSslConfig(trustManager, hostnameVerifier);

TLS on older devices

TlsUpdater tlsUpdater = new LegacyTlsUpdaterAdapter(context); // provided by :main

Making requests

// Simple GET
HttpRequest req = client.request(uri, HttpMethod.GET);
HttpResponse resp = req.execute();

// POST with body
HttpRequest post = client.request(uri, HttpMethod.POST, jsonBody);
HttpResponse resp = post.execute();

// POST with body and extra headers
HttpRequest post = client.request(uri, HttpMethod.POST, jsonBody, extraHeaders);
HttpResponse resp = post.execute();

// SSE streaming
HttpStreamRequest stream = client.streamRequest(uri);
HttpStreamResponse streamResp = stream.execute();

Global headers

client.setHeader("Authorization", "Bearer " + apiKey);
client.addHeaders(commonHeaders);

// Streaming-specific headers (only applied to streamRequest calls)
client.setStreamingHeader("SplitSDKClientKey", clientKey);
client.addStreamingHeaders(streamingHeaders);

URI building

URI uri = new URIBuilder(new URI("https://sdk.split.io/api"), "splitChanges")
        .addParameter("since", "-1")
        .build();