A Java library which implements the complete functionality of the Campaign Monitor API.
Jar files are distributed to Sonatype and Maven Central. Development snapshots are available from the Sonatype snapshots repository, and production releases are available from either the Sonatype releases repository or the Maven Central repository.
The Campaign Monitor API supports authentication using either OAuth or an API key.
This library helps you authenticate using OAuth, as described in the Campaign Monitor API documentation. You may also wish to reference this Java example application. The authentication process is described below.
The first thing your application should do is redirect your user to the Campaign Monitor authorization URL where they will have the opportunity to approve your application to access their Campaign Monitor account. You can get this authorization URL by using com.createsend.General.getAuthorizeUrl(), like so:
String authorizeUrl = com.createsend.General.getAuthorizeUrl(
32132, // The Client ID for your application
"http://example.com/", // Redirect URI for your application
"ViewReports", // The permission level your application requires
"some state data" // Optional state data to be included
);
// Redirect your users to authorizeUrl.If your user approves your application, they will then be redirected to the redirect URI you specified, which will include a code parameter, and optionally a state parameter in the query string. Your application should implement a handler which can exchange the code passed to it for an access token, using com.createsend.General.exchangeToken() like so:
com.createsend.models.OAuthTokenDetails tokenDetails = com.createsend.General.exchangeToken(
32132, // The Client ID for your application
"982u39823r928398", // The Client Secret for your application
"http://example.com/", // Redirect URI for your application
"8dw9uq98wu98d" // The unique code for your user found in the query string
);
// Save your access token, 'expires in' value, and refresh token (in tokenDetails).At this point you have an access token and refresh token for your user which you should store somewhere convenient so that your application can look up these values when your user wants to make future Campaign Monitor API calls.
Once you have an access token and refresh token for your user, you can authenticate and make further API calls like so:
import com.createsend.General;
import com.createsend.models.clients.ClientBasics;
import com.createsend.util.OAuthAuthenticationDetails;
import com.createsend.util.exceptions.CreateSendException;
public class Tester {
public static void main(String[] args) throws CreateSendException {
OAuthAuthenticationDetails auth = new OAuthAuthenticationDetails(
"your access token", "your refresh token");
General general = new General(auth);
ClientBasics[] clients = general.getClients();
}
}All OAuth tokens have an expiry time, and can be renewed with a corresponding refresh token. If your access token expires when attempting to make an API call, a com.createsend.util.exceptions.ExpiredOAuthTokenException will be thrown, so your code should handle this. Here's an example of how you could do this:
import com.createsend.General;
import com.createsend.models.clients.ClientBasics;
import com.createsend.util.OAuthAuthenticationDetails;
import com.createsend.util.exceptions.CreateSendException;
import com.createsend.util.exceptions.ExpiredOAuthTokenException;
public class Tester {
public static void main(String[] args) throws CreateSendException {
OAuthAuthenticationDetails auth = new OAuthAuthenticationDetails(
"your access token", "your refresh token");
General general = new General(auth);
ClientBasics[] clients;
try {
clients = general.getClients();
} catch (ExpiredOAuthTokenException ex) {
OAuthTokenDetails newTokenDetails = general.refreshToken();
// Save your updated access token, 'expires in' value, and refresh token
clients = general.getClients(); // Make the call again
}
}
}import com.createsend.General;
import com.createsend.models.clients.ClientBasics;
import com.createsend.util.ApiKeyAuthenticationDetails;
import com.createsend.util.exceptions.CreateSendException;
public class Tester {
public static void main(String[] args) throws CreateSendException {
ApiKeyAuthenticationDetails auth = new ApiKeyAuthenticationDetails(
"your api key");
General general = new General(auth);
ClientBasics[] clients = general.getClients();
}
}This example of listing all your clients and their campaigns demonstrates basic usage of the library and the data returned from the API:
import com.createsend.Clients;
import com.createsend.General;
import com.createsend.models.campaigns.DraftCampaign;
import com.createsend.models.clients.ClientBasics;
import com.createsend.util.OAuthAuthenticationDetails;
import com.createsend.util.exceptions.CreateSendException;
public class Tester {
public static void main(String[] args) throws CreateSendException {
OAuthAuthenticationDetails auth = new OAuthAuthenticationDetails(
"your access token", "your refresh token");
General general = new General(auth);
General general = new General(auth);
ClientBasics[] clients = general.getClients();
for (ClientBasics cl : clients) {
System.out.printf("Client: %s\n", cl.Name);
Clients cls = new Clients(auth, cl.ClientID);
System.out.printf("- Campaigns:\n");
for (DraftCampaign cm : cls.draftCampaigns()) {
System.out.printf(" - %s\n", cm.Subject);
}
}
}
}See the samples directory for more example code.
Full javadoc for this library is available here.
Run the following command from the root directory of the repository:
gradle -i
Gradle can be used to create the .classpath and .project files to import the project into Eclipse. Run the following command from the root directory of the repository:
gradle eclipse
Gradle can be used to create an IDEA project and module files. Run the following command from the root directory of the repository:
gradle idea
Please check the guidelines for contributing to this repository.
Please check the instructions for releasing this library.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent