HTTP API - Get Started
The HTTP API allows you to send and receive SMS messages through your Ozeki SMS Gateway with the help of HTTP requests. Requests can be done using both the GET and POST HTTP methods and you can use http or https, depending on your configuration.
For each HTTP request, you must include a set of mandatory parameters. These are: action, username and password. The action defines the command you wish to execute, and the username and password identify you. To How to create an HTTP API user guide gives you information about how to create a username and password.
Example HTTP request:
https://127.0.0.1:9508/api?action=sendmessage&username=admin&password=abc123&
recipient=06203105366&messagedata=Hello+World
Example HTTP response:
StatusCode: 200, ReasonPhrase: 'OK'
You are advised to try this example with the HTTP API Tester which is a GUI interface for Ozeki SMS Gateway API testing. You can find the HTTP API Tester tutorial here.
Mandatory parameters in every HTTP API request
Parameter | Description | Possible values | Example | M/O* |
action | The name of the action. | sendmessage, receivemessage, | action=sendmessage | M |
username | Specifies the username. The username and password parameters are used to authenticate the user. When you send a message it will be sent in the name of the authenticated user. The value must be URL encoded. | string value | username=admin | M |
password | Specifies the password. The username and password parameters are used to authenticate the user. When you send a message it will be sent in the name of the authenticated user. The value must be URL encoded. |
string value, minimum length: 6 characters |
password=abc123 | M |
* M = Mandatory parameter, O = Optional parameter
To sum it up
In the article above, we provided some information about the HTTP API. Using an HTTP API means that you can manage your SMS messages with HTTP requests. The Ozeki SMS Gateway is a crucial element of this system. Using HTTP requests to send and receive SMS messages means that you can build a system that can send and receive SMS messages using a web browser. This will make information flow much faster in your organization.
If you want to learn more about this system, you can visit our webpage where you can find articles about using the HTTP SMS API to send or to receive messages.
The first step of developing a solution that can send and receive messages using a web page, is to download the Ozeki SMS Gateway.
More information