Skip to content

voximplant/apiclient-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Voximplant API client library

Version 1.9.0

Prerequisites

In order to use the Voximplant Java SDK, you need the following:

  1. A developer account. If you don't have one, sign up here.
  2. A private API key. There are 2 options to obtain it:
    1. Either generate it in the Voximplant Control panel
    2. Or call the CreateKey HTTP API method with the specified authentication parameters. You'll receive a response with the result field in it. Save the result value in a file (since we don't store the keys, save it securely on your side).
  3. JDK 8 and above

How to use

Setup a maven dependency for your project:

<dependency>
    <groupId>com.voximplant</groupId>
    <artifactId>apiclient</artifactId>
    <version>1.9.0</version>
</dependency>

Next, specify the path to the JSON service account file in the constructor.

VoximplantAPIClient api=new VoximplantAPIClient("/path/to/credentials.json");

Examples

Get a call history item

VoximplantAPIClient api=new VoximplantAPIClient("/path/to/credentials.json");

        SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd");

        GetCallHistoryResponse callHistory=api.getCallHistory(new GetCallHistoryRequest()
        .setFromDate(df.parse("2020-09-01"))
        .setToDate(df.parse("2020-10-01"))
        .setCount(1));

        CallSessionInfoType[]callSessions=callHistory.getResult();
        if(callSessions.length==1){
        CallSessionInfoType result=callSessions[0];
        }

Send an SMS

VoximplantAPIClient api=new VoximplantAPIClient("/path/to/credentials.json");

        SendSmsMessageResponse sendSmsMessageResponse=api.sendSmsMessage(new SendSmsMessageRequest()
        .setSource("447443332211")
        .setDestination("447443332212")
        .setSmsBody("Test message"));

        if(sendSmsMessageResponse.hasResult()){
        long result=sendSmsMessageResponse.getResult();
        }else{
        throw new IllegalArgumentException(sendSmsMessageResponse.getError().getMsg());
        }