{"id":15508554,"url":"https://github.com/vincejv/m360-api-client","last_synced_at":"2026-01-07T22:04:48.316Z","repository":{"id":191223640,"uuid":"684283267","full_name":"vincejv/m360-api-client","owner":"vincejv","description":"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!","archived":false,"fork":false,"pushed_at":"2024-01-02T15:22:32.000Z","size":130,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T19:46:37.730Z","etag":null,"topics":["api","asynchronous","globe","java","m360","m360-api","reactive","rest","sms"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vincejv.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-28T20:28:47.000Z","updated_at":"2023-08-28T20:30:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"50ddaccd-e9be-43a5-b287-23d5cd092493","html_url":"https://github.com/vincejv/m360-api-client","commit_stats":null,"previous_names":["vincejv/m360-api-client"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincejv%2Fm360-api-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincejv%2Fm360-api-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincejv%2Fm360-api-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vincejv%2Fm360-api-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vincejv","download_url":"https://codeload.github.com/vincejv/m360-api-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246083290,"owners_count":20720939,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","asynchronous","globe","java","m360","m360-api","reactive","rest","sms"],"created_at":"2024-10-02T09:39:08.192Z","updated_at":"2026-01-07T22:04:48.287Z","avatar_url":"https://github.com/vincejv.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# M360 API Java Client\n\n\u003cimg src=\"banner.png\" alt=\"FPI Framework\" width=\"500\"/\u003e\n\n[![Maven Central version](https://img.shields.io/maven-central/v/com.vincejv/m360-api-client?logo=apache-maven)](https://search.maven.org/artifact/com.vincejv/m360-api-client)\n[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/vincejv/m360-api-client/Maven%20Central%20deployment?label=CI/CD\u0026logo=github)](https://github.com/vincejv/m360-api-client/actions?query=workflow%3A%22Maven+Central+deployment%22)\n[![License](https://img.shields.io/github/license/vincejv/m360-api-client?logo=apache)](https://github.com/vincejv/m360-api-client/blob/main/LICENSE)\n[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/vincejv/m360-api-client?label=commits\u0026logo=git)](https://github.com/vincejv/m360-api-client/pulse)\n[![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=vincejv_m360-api-client)\n[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=vincejv_m360-api-client)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=reliability_rating)](https://sonarcloud.io/dashboard?id=vincejv_m360-api-client)\n[![SonarCloud Bugs](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=bugs)](https://sonarcloud.io/component_measures/metric/reliability_rating/list?id=vincejv_m360-api-client)\n[![SonarCloud Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=vulnerabilities)](https://sonarcloud.io/component_measures/metric/security_rating/list?id=vincejv_m360-api-client)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=vincejv_m360-api-client)\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=vincejv_m360-api-client\u0026metric=ncloc)](https://sonarcloud.io/dashboard?id=vincejv_m360-api-client)\n\nLanguage: Java\n\nAn Open Source Client Library for Java applications to integrate and interact with\nthe M360 Messaging API of [m360 - Globe Business](https://www.globe.com.ph/business/sme/solutions/sms-api.html)\n\nThis library takes care of handling the API requests/responses to allow developers to\nfocus on the business logic offered by the integration with M360's Messaging API. The goal of this\nclient is to ensure that the integration with M360 is seamless and hassle-free. Drop us a line in\nthe issue tracker if you feel that it can be improved!\n\n## Features\n- Ready-to-use interfaces to consume M360's [Messaging API](https://www.globe.com.ph/business/sme/solutions/sms-api.html)\n- Common response object\n- ~~Unit and functional testing with mocked responses from the API.~~ TODO\n- Asynchronous calls\n\n## Domain Objects\nThis library deals with the following list of domain objects from the DVS API:\n - BroadcastResponse\n - BroadcastRequest\n - SMSRequest\n\n## Installation \u0026 Usage\n\n- Requires Java 17 or later\n\n- The library is available to be installed as a Maven Dependency or Standalone Java Archive.\n\n    1. Maven Dependency\n\n       - Add the following dependency in your `pom.xml`\n\n           ```xml\n           \u003cdependency\u003e\n               \u003cgroupId\u003ecom.vincejv\u003c/groupId\u003e\n               \u003cartifactId\u003em360-api-client\u003c/artifactId\u003e\n               \u003cversion\u003e1.0.2\u003c/version\u003e \u003c!-- replace with latest version --\u003e\n           \u003c/dependency\u003e\n           ```\n    2. Standalone JAR\n        - Feel free to download the latest JAR with the dependencies directly from maven central [here](https://repo.maven.apache.org/maven2/com/vincejv/m360-api-client/)\n        and add the jar to the classpath of your project.\n  \n- Create an instance from `M360ApiClient` with your basic auth keys and sender id or shortcode mask\n    ```java\n    import com.vincejv.m360;\n    \n    var m360Client = new M360ApiClient(String baseApiUrl, String appKey,\n          String appSecret, String senderId)\n    ```\n- Start calling the M360 API!\n\n## Basic Troubleshooting and frequently asked questions:\n\n- Should an application create more than one `M360ApiClient`?\n    \n    There should be no need to do that in a single application.\n\n## License\n- [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvincejv%2Fm360-api-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvincejv%2Fm360-api-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvincejv%2Fm360-api-client/lists"}