Wire2Air MMS Send API
Wire2Air provides simple HTTP interface for clients to send MMS messages to
mobile phone users. HTTP POST or GET can be used in all modern
programming languages including ASP, ASP.NET, C++, C#, PHP, VB, VB.NET,
command lines, SSH & cURL.
Send MMS using Wire2Air Gateway
To submit messages from any programming language, you should
message in the following format.
HTTP URLs
http://mms.wire2air.com/mms/submitmms.aspx
HTTP METHOD
Messages should be sent as a HTTP POST or GET using the
parameters listed below. One request should be sent per message.
HTTP Form Variables
| Name | Description |
|---|---|
| *VERSION | 1.0 |
| *USERID | YOUR_USERID; PROVIDED BY WIRE2AIR |
| *PASSWORD | YOUR_PASSWORD; PROVIDED BY WIRE2AIR |
| *VASID | YOUR_VASID; PROVIDED BY WIRE2AIR |
| *FROM | SHORT CODE NUMBER ; PROVIDED BY WIRE2AIR |
| *TO | DESTINATION MOBILE NUMBER.
[(country code) + mobile number] e.g 17321234567 (for US), 919810601000 (for India) |
| *Subject | MMS Subject |
| *BaseURL | This parameter indicates the base URL where all files needed in the MMS message can be found.
e.g http://[YOURSERVER]/10900/ |
| *Attachments | This parameter provides list of all files needed in the MMS message. In order to send MMS messages,
the MMS gateway will fetch the files from BASE URL provided by the server of the customer. e.g logo.gif, animal.amr, etc |
| MMSCode (optional) | Required only if attachments parameter is not supplied.
The MMSCode of MMS message from Wire2air mms repository or previously sent MMS. |
| DeliveryDateTime (optional) | Default: Now
Date and time for message delivery in UTC MM/DD/YYYY HH:MM:SS format. Example: 11/6/2010 7:41:06 PM EST (UTC date for 11/6/2010 3:41:06 PM) |
Response from Send SMS APIs
The API will return a string message to the calling application.
Successful submission:
JOBID: [MOBILENUMBER]:[MMSID]:[MMSCODE]
Error messages
ERR:301: Failed authentication
ERR:302: Invalid vasid
ERR:303: Invalid password
ERR:304: Invalid logon
ERR:306:Message Receipient is missing
ERR:305: Not enough credits
ERR:307: Invalid delivery date time.
ERR:312: Failed to download content object.
ERR:313: Invalid MMS Code
ERR:314: Invalid MMS Code or no files specified.
ERR:400: System error
Example POST Request [ASP]
sstrData = “version=2.0”
sstrData = “To=” & [Mobile Number]
sstrData = sstrData + “&From=27126”
sstrData = sstrData + “&UserId=XXXXX”
sstrData = sstrData + “&Password=XXXXX”
sstrData = sstrData + “&vasid=XXXX”
sstrData = sstrData + “&subject=Demo Message”
sstrData = sstrData + “&BaseURL=http://www.wire2air/testmms/”
sstrData =sstrData + “&attachments=220.jpg,119.amr,223.jpg”
Set myhttp=CreateObject (“Msxml2.XMLHTTP”)
Myhttp.open (“POST”, “http://mms.wire2air.com/mms/submitmms.aspx”, false)
Myhttp.setRequestHeader “Content-Type”, “application/x-www-form-urlencoded”
Myhttp.send sstrData
Response.write myhttp.responsetext
Set myhttp = Nothing