Java SDK

String authKey = "A71326F793"; // replace with your authentication key
String baseURL = "https://sandbox.apstrata.com; // replace with the URL to your Apstrata application account
 
// Example 1, using an OwnerConnection
// Create an instance of OwnerConnection using your Apstrata authentication Key and secret 
String secret = "F2A0240C8F61652GD45173BF0EC223X1"; // replace with your secret
Connection ownerConnection = new OwnerConnection(baseUrl, authKey, secret);
 
// Create an instance of the Apstrata Java Client with the above Connection instance
Client client = new Client(baseURL, authKey, ownerConnection);
 
// Determine the signature mode to use (Complex or Simple)
Client.AuthMode mode = Client.AuthMode.COMPLEX;
 
// Prepare the parameters to send according to the requested Apstrata API (In this example, "SaveDocument")
List<NameValuePair> parameters = new ArrayList<NameValuePair>();
parameters.add(new BasicNameValuePair("apsdb.store", "DefaultStore"));
parameters.add(new BasicNameValuePair("apsdb.update", "false"));
parameters.add(new BasicNameValuePair("some_field_to_save", "blah"));
 
// Invoke the API using the Client instance and signature mode 
// note that since we're not passing files, we send "null" in place of the "files" parameter
String response = client.callAPIJson("SaveDocument", parameters, null, mode);
 
// Example 2, using a TokenConnection 
// TokenConnection require the addition of two steps to the scenario above. Since a token needs to be regularly renewed
// and since it has a limited life-time (cannot renew a token for ever without re-sending credentials), 
// we need to explicitly instruct the TokenConnection instance to start refreshing the token, respectively 
// stop doing it.
 
// Let's start by creating an instance of TokenConnection
String username = "someUser@somemail.com"; // You normally would get this from a Login form
String password = "somePassword"; // You normally would get this from a Login form
long tokenExpiry = 60; // The time in seconds before before discarding the token
long tokenLifetime = 120; // The time in seconds before having to resend user credentials to renew the token 
TokenConnection tokenConnection = null;
 
try {
 
	tokenConnection = new TokenConnection(baseURL , authKey , username, password, tokenExpiry, tokenLifetime);
 
	// Ask the TokenConnection to validate its current token, if not token existed, one is generated and true is returned
	// (false will be returned in case of passing invalid user credentials)
	boolean isValid = tokenConnection.validateToken();
	if (isValid) {
 
		// Create an instance of the Apstrata Java Client with the above Connection instance
		client = new Client(baseURL, authKey, tokenConnection);
	
		// invoke some APIs ...
	}
}catch(Exception e) {
	// Do some exception handling ...
}finally {
	// Terminate the connection if not needed anymore
	if (tokenConnection != null) {
		tokenConnection.terminate();
	}
}