Thinking about implementing the Infobip SMS API? – Don’t worry, it’s fast and easy – so easy that we’ve even created a demo app to demonstrate.
First step is to create an Infobip account and after you’ve done that you can download our SMS Demo App. The app doesn’t require installation, so running the file will immediately open the login screen which will just ask for Infobip credentials. By providing them you can use the app to start your own project, or simply take a look.
The demo SMS app
The app has three basic functions:
- Send SMS
- Get delivery report for the message sent
- Get the sent message log
So, what’s the deal with the delivery report and SMS log? Well, the SMS log will be available for 48 hours and your message content will be accessible during that period. If you need an access to a specific message log you will be able to search for it through some filters, like sender or destination address, SMS status, etc. On the other hand, the delivery report is a one-time thing that will give you the option to check if the messages were successfully delivered.
About the code
The app is a simple desktop program written in Java – its code can be found on Github. It requires a Java version 8 or later, Maven version 3 and Git. Those requirements can be checked by running the Command Prompt on Windows.
The app code is structured in per feature packages, which means that all of the code related to, say, sending SMS is located in a package called “send”. Additionally, that package includes a UI package that contains classes implementing parts of the JavaFX framework needed to render the send SMS form and handle user input.
Start building the app
To start building the app you have to download the source code locally. You can download a ZIP archive from GitHub page, or use Git to clone the repository.
If you choose to clone the repository, you have to open your terminal and position yourself in the directory you want the project to be downloaded in. When the directory is ready it’s time to execute the git clone command.
After executing the command, Git will create a new directory called infobip-api-java-demo and download the content of the repository to it. You can test the created directory to see its validity by checking the existence of these files: .gitignore, License, pom.xml, README.md.
If the files are there, source code has been successfully downloaded and you can build it by executing mvn install command into your newly created directory infobip-api-java-demo. Your root project directory will have a new directory named target.
For running the installed Demo app, position yourself in the target directory. Your position should be accurate if you followed these steps. Next step is to simply run the app using:
C:infobip-api-java-demotarget>java -jar DemoApp.jar
If everything has been done right the app should start, present you the login screen, where you can enter your credentials and start sending messages and reviewing delivery reports and logs.