Pluggy Java

Java Bindings for the Pluggy API (https://docs.pluggy.ai/).

For available SDK API methods, check PluggyApiService interface methods.

This implementation uses Retrofit and OkHttp libraries. For advanced use cases, please check their respectives APIs.

Also, for examples of use, please check the integration tests - practically all of the available endpoints have at least one test case.

Install

Using Maven, add dependency to your pom.xml:

Currently, the package is available in Github Packages, so make sure to have the GH Packages server config with your Personal GH Access Token in your .m2/settings.xml file. Navigate to this guide for more details.

<dependency>
<groupId>ai.pluggy</groupId>
<artifactId>pluggy-java</artifactId>
<version>1.7.0</version>
</dependency>

Basic Usage

// Use builder to create a client instancePluggyClientpluggyClient = PluggyClient.builder()
.clientIdAndSecret("your_client_id", "your_secret")
.build();
// Authenticate your client (optional - by default, auth token is requested & refreshed as needed by ApiKeyAuthInterceptor)pluggyClient.authenticate()
// Synchronously perform a requestResponse<ConnectorsResponse> connectorsResponse = pluggyClient.service().getConnectors().execute();
// or, a request with params:Response<ConnectorsResponse> connectorsResponseFiltered = pluggyClient.service()
.getConnectors(newConnectorSearchRequest("Pluggy", Arrays.asList("AR")))
.execute();
// Read response data (or error):if(connectorsResponse.isSuccessful()) {
// successful -> get bodyConnectorsResponseconnectorsResponseBody = connectorsResponse.body();
} else {
// unsuccessful -> parse error dataErrorResponseerrorResponse = pluggyClient.parseError(connectorsResponse)
}