MMS Gateway - HTTP Interface

You can send MMS messages using the HTTP/S interface. The MMS message is submitted over the HTTP interface using the Multipart Form Data format.

Submission URL:

https://www.intellisoftware.co.uk/smsgateway/default.aspx

For secure SSL connection use https:

Request Data:

Request data contains submission parameters and the MMS message part files

Content-Type: multipart/form-data; boundary=AaB03x

--AaB03x
Content-Disposition: form-data; name="username"
Content-Type: text/plain

YourUsername
--AaB03x
Content-Disposition: form-data; name="password"
Content-Type: text/plain

YourPassword
--AaB03x
Content-Disposition: form-data; name="to"
Content-Type: text/plain

0771012345
--AaB03x
Content-Disposition: form-data; name="from"
Content-Type: text/plain

0771054321
--AaB03x
Content-Disposition: form-data; name="type"
Content-Type: text/plain

5
--AaB03x
Content-Disposition: form-data; name="text"
Content-Type: text/plain

MMS Message Subject
--AaB03x
Content-Disposition: form-data; filename="file1.txt"
Content-Type: text/plain

... contents of file1.txt ...
--AaB03x
Content-Disposition: form-data; filename="file2.gif"
Content-Type: image/gif
Content-Transfer-Encoding: binary

...contents of file2.gif...
--AaB03x--

Parameters:

username=	This is the username of your account
password=	This is the password for your account
to=	This is the destination phone number. A maximum of 100 numbers can be specified, separated by commas.
text=	The content of the MMS message subject message (UTF-8 Encoded)
from=	(Optional) This is the source/sender's phone number. Leave blank to receive replies. Can be numerical (e.g. long number or shortcode), alphanumeric sender's Id's not supported.
type=	Message Type (5 = MMS Message)

Responses:

ID:10011000000000000001	Message has been sent to the gateway. The unique message ID follows 'ID:'
ERR:LOGIN_INVALID	Username or Password is invalid
ERR:INSUFFICIENT_CREDIT	Insufficient credit balance to fulfil request
ERR:NO_XXXXXXXXXXX	A mandatory parameter is missing
ERR:INVALID_NUMBER	Unable to route to the destination phone number
ERR:INVALID_REQUEST	The request was not valid
ERR:GATEWAY_ERROR	Unable to process request at this time
ERR:INTERNAL_ERROR	Unable to process request at this time

Response Formats:

Single line response is returned when sending to a single recipient or when the whole submission fails:

ID:10011000000000000001

ERR:INSUFFICIENT_CREDIT

Multiline response is returned when sending to multiple recipients:

44771012345,ID:10011000000000000001
44771012346,ID:10011000000000000001
44771054321,ERR:INVALID_NUMBER

A line is returned per recipient. Each line contains the recipient's number (international format), followed by comma, followed by the response. The ID applies to the whole submission and is identical for each recipient.

NOTE: The phone numbers listed in the response may not be identical to the numbers submitted. This is due to processing done to the numbers, e.g. international dialling codes added, duplicate numbers removed.

<< Back to HTTP Interface