Wire2Air provides a 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
https://mms.wire2air.com/mms/submitmms.aspx
HTTP METHOD
Messages should be sent as an HTTP POST or GET using the parameters listed below. One request should be sent per message.
HTTP Form Variables
| NAME | DESCRIPTION |
|---|---|
| *VERSION | 1.0 |
| *APIKEY | YOUR_APIKEY; How to Generate an API key |
| *FROM | TEXTING NUMBER ASSIGNED TO YOUR ACCOUNT |
| *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 the BASE URL provided by the server of the customer. e.g logo.gif, animal.amr, etc |
| MMSCode (optional) | Required only if the 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 MMS 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 Recipient 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 + “&APIKEY=XXXXX”
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”, “https://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