M360 API Java Client

Language: Java

An Open Source Client Library for Java applications to integrate and interact with the M360 Messaging API of m360 - Globe Business

This library takes care of handling the API requests/responses to allow developers to focus on the business logic offered by the integration with M360's Messaging API. The goal of this client is to ensure that the integration with M360 is seamless and hassle-free. Drop us a line in the issue tracker if you feel that it can be improved!

Features

• Ready-to-use interfaces to consume M360's Messaging API
• Common response object
• Unit and functional testing with mocked responses from the API. TODO
• Asynchronous calls

Domain Objects

This library deals with the following list of domain objects from the DVS API:

• BroadcastResponse
• BroadcastRequest
• SMSRequest

Installation & Usage

• Requires Java 17 or later

• The library is available to be installed as a Maven Dependency or Standalone Java Archive.

  1. Maven Dependency

     • Add the following dependency in your pom.xml

       <dependency>
           <groupId>com.vincejv</groupId>
           <artifactId>m360-api-client</artifactId>
           <version>1.0.2</version> <!-- replace with latest version -->
       </dependency>

  2. Standalone JAR

     • Feel free to download the latest JAR with the dependencies directly from maven central here and add the jar to the classpath of your project.

• Create an instance from M360ApiClient with your basic auth keys and sender id or shortcode mask

  import com.vincejv.m360;
  
  var m360Client = new M360ApiClient(String baseApiUrl, String appKey,
        String appSecret, String senderId)

• Start calling the M360 API!

Basic Troubleshooting and frequently asked questions:

• Should an application create more than one M360ApiClient?

  There should be no need to do that in a single application.

License

• Apache License 2.0