This document will provide instructions on how to quickly integrate SMS messaging services into various solutions by using HTTP application programming interface (HTTP API). The HTTP API can be used for sending SMS messages, collecting delivery reports, making Number Context (number validation) requests and receiving inbound SMS messages sent from mobile phones.

API is based on REST standards, enabling you to use your browser for accessing URLs. In order to interact with our API, any HTTP client in any programming language can be used.

Base URL

Submit all requests to the base URL. All the requests are submitted thorough HTTP POST or GET method.

https://api.*****.com

Content-Type & Accept header

API supports JSON and XML Content-Types and Accept criteria that should be specified in the header. If the Content-Type is not specified, you will receive a general error. Depending on which Accept type is chosen in the deader for the request, the same one will be applied in the response.

Content-Type: application/json or application/xml

Accept header: application/json or application/xml

Authorization

We support basic authorization using a username and password with Base64 encoding variation RFC2045-MIME.

The authorization header is constructed as follows:

Username and password are combined into a string username:password
The resulting string is encoded using the RFC2045-MIME variant of Base64.
The authorization method and a space, like this: "Basic ", are put before the encoded string.

Example

Username: Aladdin

Password: open sesame

Base64 encoded string: QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Authorization header: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==