1. Get Balance
To get your balance of your account at simosms.com
URL:
http://rest.simosms.com/MainService.svc/xml/GetBalance/{APIKey}/{SecrectKey}
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:
When using Unicode message, message must be encoded before:
Example:
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
http://rest.simosms.com/MainService.svc/xml/SendMultipleMessage_V4/
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:
http://rest.simosms.com/MainService.svc/xml/GetSmsReceiverStatus_V2?SMSID={SMSID}&ApiKey={ApiKey}&SecretKey={SecretKey}
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 |