README.md

Plivo Java Helper Library

Description

The Plivo Java helper simplifies the process of making PLIVO API Calls and generating PLIVO XML.

See Plivo Documentation for more information.

Pre-built jars

plivo-java-3.0.2-jar-with-dependencies.jar
plivo-java-3.0.2-jar-with-dependencies.jar.asc

Use this if you have issues with conflicting jars in your project. See the pom.xml for the list of dependencies you will need to include.

plivo-java-3.0.2.jar
plivo-java-3.0.2.jar.asc

Manual Install

Download and Install Maven3

http://maven.apache.org

Maven in 5 minutes guide

Generating a release

To generate the final release,

mvn install -Dmaven.test.skip=true

Note: The parameter -Dmaven.test.skip=true will skip all test and generate the release.

Use the Library in your Java IDE

Create Stubs for Eclipse

mvn eclipse:eclipse

Create stubs for idea

mvn idea:idea

How to use

Making a Call.

RestAPI restAPI = new RestAPI("<AUTH_ID>", "<AUTH_TOKEN>", "v1");

LinkedHashMap<String, String> params = new LinkedHashMap<String, String>();
	params.put("from", "xxxxxxxxxx");
	params.put("to", "xxxxxxxxxx");
	params.put("answer_url", "http://server/url/answer.xml");

	Call response;
	try {
		response = restAPI.makeCall(params);
		System.out.println(response.apiId);
	} 
	catch (PlivoException e) {
		System.out.println(e.getMessage());
	}

Check the examples

Note

admin@plivo.com: GPG public key