1. Get Balance

To get your balance of your account at simosms.com

URL:

You just send an http get request to above URL

Format of Response:

< MemberModel xmlns="http://schemas.datacontract.org/2004/07/AdvertisingAPI.Model" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" >
< Balance > 47385280 < /Balance >
< CodeResponse >100< /CodeResponse >
< ErrorMessage i:nil="true"/ >
< /MemberModel >

Detail Information in Response

Item Information
CodeResponse ---
ErrorMessage ---

Information of CodeResponse

Code Information
100: Request is Successful
99: Undefined error
101: Invalid APIKey or SecretKey
102: Account is locked
103: Not enough balance to send SMS
104: Incorrect Brand

2. Send SMS using Restful

Allow you to send SMS by RESTful request

URL format:

http://rest.simosms.com/MainService.svc/xml/SendMultipleMessage_V4 ?Phone={Phone}&Content={Content}&ApiKey={ApiKey}&SecretKey={SecretKey}&IsUnicode={IsUnicode}&Brandnamme={BrandnameCode}&SmsType={SmsType}

Parameter:

STT Item Data Type Information
01 APIKEY String APIKey was supplied when register at simosms.com
02 SECRETKEY String SecretKEY was supplied when register at simosms.com
03 Phone String SecretKEY was supplied when register at simosms.com
04 Content String SecretKEY was supplied when register at simosms.com
05 IsUnicode String SecretKEY was supplied when register at simosms.com
06 BrandnameCode String SecretKEY was supplied when register at simosms.com
07 SmsType String SMS Type
2: Alpha Sender
8: Random numbers

Response:

< SmsResultModel >
< CodeResult > < /CodeResult >
< ErrorMessage > < /ErrorMessage >
< SMSID > < /SMSID >
< /SmsResultModel >

Response information

Item Information
SMSID ID of SMS was created, this ID can be using to get detail status of SMS
CodeResult See table bellow
ErrorMessage ---

Information of CodeResponse

Code Information
100: Request is Successful
99: Undefined error
101: Invalid APIKey or SecretKey
102: Account is locked
103: Not enough balance to send SMS
104: Incorrect Brand

Example URL:

http://rest.simosms.com/MainService.svc/xml/SendMultiplsimoSMS_v3?Phone=0933556925&Content=Xin+ch%c3%a0o+b%e1%ba%a1n+%3a+&apikey= &secretkey=

When using Unicode message, message must be encoded before:

Example:

string Content = "Hello : ";
Content = HttpUtility.UrlEncode(Content);

3. Send SMS with Numeric Sender Using POST

Allow you to send sms with numeric Send, there 3 option:
+ Random number (send sender like 09xxxxx) (Cheapest)
+ Alpha Sender

URL

You need to make an HTTP POST Request with POST Data like Bellow:

< RQST >
< APIKEY >yourapikey< /APIKEY >
< SECRETKEY >yoursecretkey< /SECRETKEY >
< ISFLASH >0< /ISFLASH >
< SMSTYPE >X< /SMSTYPE >
< BRANDNAME >YourBrandname< /BRANDNAME >
< CONTENT >Welcome to simosms.com< /CONTENT >
< CONTACTS >
< CUSTOMER >
< PHONE >….< /PHONE >
< /CUSTOMER >
< CUSTOMER >
< PHONE >….< /PHONE >
< /CUSTOMER >
< /CONTACTS >
< /RQST >

Parameter:

Parameter Information
PHONE Number of Receiver
CONTENT Content of SMS
SmsType Choose SMS Sender
8: Random numbers
2: Alpha Sender
APIKEY APIKey was supplied when register at simosms.com
SecretKey SecretKey was supplied when register at simosms.com
BrandName Sender: just pass this if your Register Sender (Brandname) with us.
To Register please contact our hotline: 84902435340 or skype: trinhdoan1232

Response

< SmsResultModel >
< CodeResult >< /CodeResult>
< ErrorMessage >< /ErrorMessage >
< SMSID >< /SMSID >
< /SmsResultModel >

Response Information

Field Information
SMSID ID of SMS was created, this ID can be using to get detail status of SMS
CodeResult See table bellow
ErrorMessage ---

CodeResult Table

Code Information
100: Request is Successful
99: Undefined error
101: Invalid APIKey or SecretKey
102: Account is locked
103: Not enough balance to send SMS
104: Incorrect Brand

4. Get SMS Send status

Allow you to get status of sms you has sent

URL:


Parameter

Parameter Information
SMSID ID of sent SMS
APIKEY APIKEY was supplied when register at simosms.com
SecretKey SecretKey was supplied when register at simosms.com

Response:

< SmsResultModel >
< CodeResult >< /CodeResult >
< ErrorMessage >< /ErrorMessage >
< ReceiverStatus >
< Phone >< /Phone >
< Status >< /Status >
< SentTime >< /SentTime >
< /ReceiverStatus >
< /SmsResultModel >

Response Information:

Field Note
Phone Phone send destination
Status Sent Status (Buffered,Delivered,Failed)
CodeResult See table bellow
ErrorMessage Error detail

CodeResponse Table:

Code Information
100: Request is Successful
99: Undefined error
101: Invalid APIKey or SecretKey