Sending SMS using the Application Programming Interface - MCTel

More documents

Recommendations

Info

VIDEOSMS HTTP/HTML Interface Manual v. 1.2Perform the HTTP requests in NoCache mode if a HTTP proxy is installed on your enterprisenetwork.When connecting it is necessary to specifiy your username and password (and in some casea company name and optionnaly a company password). You could get these parameters byseveral ways:• your company has opened an account: your parameters has been given to you byMCTEL.• your are a MCTEL partner: same• you could also immediately (if not already done) open your own prepaid SMS accounton http://www.smsfax.com by specifying your mobile number and email address andalso the username you wish to use. If this username is not already in use, you willreceive immediately your account password by SMS on your mobile along with somefree SMS units to test your new account. You could purchase SMS units on youraccount by credit card, check and in some countries by sending a Premium SMS orconnecting to the videotex network.You could also open your account by downloading and installing the VideoSMS/PCDesktop SMS sender from http://www.smsfax.com.In all cases, whatever the method used to open your account, you could use yourusername and password to send SMS from all the methods supplied by SMS: PCDesktop sender, Web, SMS Gateway API, SMS FTP/XML Interface and the SMSHTTP/HTML interface described in this document.Submitting requests to the gatewayThe client should transmit requests using either HTTP GET or HTTP POST requests to thegateway. Submissions sent to the gateway should conform to the syntax described below.Using HTTP GET requestsFollow the following procedure :• connect to the www.smsfax.com gateway on port 8080 (see above).• transmit the GET request to the /cgi-bin/sendsms.cgi URI• send the GET request containing the needed parameters, transmitted after the URI andthe ? character, each parameter beeing encoded and separated by & (parametersencoding and formating are usually automatically performed by HTTP functions).• Do not close the connection after the request in order to be able to receive the replyfrom the gateway.Using HTTP POST requestsFollow the following procedure :• connect to the www.smsfax.com gateway on port 8080 (see above).• transmit the POST request to the /cgi-bin/sendsms.cgi URI.• The POST request must contain the following mandatory HTTP headers, separatedfrom the message content by :Monaco Telematique MCTEL 18 July 2004
VIDEOSMS HTTP/HTML Interface Manual v. 1.2o Content-type : application/x-www-form-urlencodedo Accept-charset : utf-8o Content-length : nnn (where nnn is the length of the body).• Do not close the connection after the request in order to be able to receive the replyfrom the gateway.Request format and attributesThe HTTP requests sent to the URI must contains mandatory parameters, optional parametersmay be added. The required parameters may vary according to the type of HTTP request(SMS send, SMS check status, SMS Wap Push, and so on.). The attributes values may notcontain leading spaces, linefeed characters or quotation marks.Common parameters for all requestsAttribute name Meaning ExampleMandatory Attributes‘Command’ Specify the type of command to be performed : sendsms• ‘sendsms': sending a SMS or othermessage types (fax, telex, email...).• ‘readstatus’: check the status of apreviously transmitted message.• 'wappush': send a Wap Push commandby SMS‘UserId’‘UserPwd’‘Version’NB : according to the command specified, seebelow the mandatory and optional attributesto be specified.Registered username for authentication.If you have created yourself your own accounton www.smsfax.com or using theVideoSMS/PC Desktop sender program, specifyyour username. In this case, all SMS sent fromusing the HTTP/HTML interface will becharged to your www.smsfax.com account.Username is not case sensitive.Password securing the username, forauthentication.If you have created yourself your own accounton www.smsfax.com or using theVideoSMS/PC Destop sender program, specifyyour password that has been transmitted by thegateway to your mobile phone.Password are case sensitive.Protocol version number. The current protocolversion is 1.0Optional AttributesmctelX7u2Hzq7w11.0Monaco Telematique MCTEL 19 July 2004
Page 5 and 6: VIDEOSMS HTTP/HTML Interface Manual

Sending SMS using the Application Programming Interface - MCTel

Create successful ePaper yourself

Delete template?

Save as template?