Java Quick Start


Get an API Key and Secret


If you haven’t already, sign up for a free trial.

Include the PasswordPing Library


The Java package is available either via package manager or direct download.

Maven

The passwordping-java-client is available in Maven Central. Just include the following in your pom.xml dependencies section.

<dependencies>
    <dependency>
      <groupId>com.passwordping</groupId>
      <artifactId>passwordping-java-client</artifactId>
      <version>1.0.3</version>
    </dependency>
</dependencies>

Gradle

Include the following in your build.gradle dependencies section.

dependencies {
  compile 'com.passwordping:passwordping-java-client:1.0.3'
}

Download

You can download a version of the .jar directly from
https://oss.sonatype.org/content/groups/public/com/passwordping/passwordping-java-client/

Try Out Our Example Code


We’ve made calling the API dead simple. This sample code snippet shows you examples of calling the four supported APIs:

// Create a new PasswordPing instance - this is our primary interface for making API calls
PasswordPing passwordping = new PasswordPing(YOUR_API_KEY, YOUR_API_SECRET);
 
// Check whether a password has been compromised
if (passwordping.CheckPassword("password-to-test")) {
    System.out.println("Password is compromised");
}
else {
    System.out.println("Password is not compromised");
}
 
// Check whether a specific set of credentials are compromised
if (passwordping.CheckCredentials("test@passwordping.com", "password-to-test")) {
    System.out.println("Credentials are compromised");
}
else {
    System.out.println("Credentials are not compromised");
}
 
// get all exposures for a given user
ExposuresResponse exposures = passwordping.GetExposuresForUser("test@passwordping.com");
System.out.println(exposures.getCount() + " exposures found for test@passwordping.com");
 
// now get the full details for the first exposure found
ExposureDetails details = passwordping.GetExposureDetails(exposures.getExposures()[0]);
System.out.println("First exposure for test@passwordping.com was " + details.getTitle());

Learn More


That should get you started. Check out the Github project page for more details.