Sending SMS using the Application Programming Interface - MCTel

More documents

Recommendations

Info

VIDEOSMS HTTP/HTML Interface Manual v. 1.2Tags returned for all the requestsTag Meaning Example Numeric result status (success or error) of the1request. Success is 1, all other values are errorcodes listed in appendix 1. Text result status of the request. Success isOK'OK'.Additional tags returned when « command=sendsms »The following tags are only returned when SMSRESULT=1 (SMS submitted successfully):Tag Meaning ExempleUnique internal reference number assigned 35817to the SMS. This reference number must bepassed to the ‘command=readstatus’ requestto get the status of a submitted SMS. If the ‘PrivateData’ attribute was included My private infoin the submit operation, its content isreturned as is. If the ‘PrivateReference’ attribute was ABC123456specified during the submit operation, itscontent is returned.Additional tags returned when « command=readstatus »The following tags are only returned when SMSRESULT=1 (SMS successfully retrieved):Tag Meaning Example Numeric state of the message. The possible1values are:• 1 : successfully delivered to recipient(reception date stored in attribute)• 2 : fatal error, could not transmit• 3 : forwarded to recipient (no deliveryacknowledgement notification )• 12 : en route/pending• 13 : transient error (will be retried atregular intervals)• 18 : processed by mobile operator• 19 : waiting for transmission (priority)• 21 : delayed delivery SMS, waiting forspecified deffered delivery date/time• 99 : unknown error Message state described in text format Received byrecipient at xxxxMonaco Telematique MCTEL 24 July 2004
VIDEOSMS HTTP/HTML Interface Manual v. 1.2 Numeric detailed error cause. A messagesuccessfully transmitted to recipient return 1.Please refer to appendex 1 for the list of errorcodes.< MSGTEXTERROR> Detailed error cause in text format explainingthe error code. When known, specify the date/time of thesuccessful reception by recipient mobile, or incase of an error of the last transmission retry.51Invalid or unknownmobile number27/07/2004 - 15:33Note : when the TestMode has been selected and set to 2 (TestMode=2), the HTML page willthen list all the request attributes received in order to help debugging the applications. In thiscase, the SMS will not be transmitted to the recipient and the user account will not beencharged.ExamplesExample of simple GET requestFrom any Web browser, you could test the sending of a SMS message by calling the URLbelow (modify your account userid and userpwd and the mobile number to use) :http://www.smsfax.com/cgibin/sendsms.cgi?command=sendsms&version=1.0&userid=mctel&userpwd=123456&msgcontent='This is a test'&destnum=%2B33607998877You will receive a return status Web page formatted as below (use the 'View source'command of your browser to see all the HTML source code) :sendsms1 Ok 138184 Warning: if the IP address check has been enabled (recommended), only GET or POSTrequests originating for the enabled authorized address will be accepted.To request the status of a SMS previously sent (specify the SMS reference returned in the field):Monaco Telematique MCTEL 25 July 2004
Page 5 and 6: VIDEOSMS HTTP/HTML Interface Manual

Sending SMS using the Application Programming Interface - MCTel

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?