The following are the features of DomeSMS :
- Send SMS to single mobile number
- Send SMS to multiple mobile number(s)
- Scheduling SMS
- Send Unicode SMS
- Send SMS to Group(s) on DomeSMS
Parameters & Examples
# |
Field Name |
Field Value |
Field Description |
| 1 | user | chimuk |
The login name for your SMS account on DomeSMS **Mandatory** |
| 2 | password | 123456 |
The login password for your SMS account on DomeSMS **Mandatory** |
| 3 | mobile | 08012345678, 080xxxxxxxx |
The target mobile number(s) separated with Comma **Mandatory** |
| 4 | senderid | wedding |
The sender name that will show as from address **Mandatory** |
| 5 | message | hi, happy birthday! |
The text message to send to the target mobile number(s) **Mandatory** |
| 6 | schedule | 2016:10:28:14:20:10 | This is to schedule the SMS to deliver in future date. The format should be yyyy:mm:dd:hh:mm:ss |
| 7 | unicode | 1 or 2 |
This is used for send Unicode sms via SMS HTTP API. Unicode=1 – You can directly send the Unicode characters. Unicode = 2 – You can send Unicode converted as hex |
| 8 | group_id | group_id=1,2 | Account holder Group(s) on DomeSMS. |
This is the API below:
https://www.domesms.com/sendsms.php?user=&password=&mobile=&group_id=&senderid=&message=&unicode=&schedule=
Note: User, password, mobile, senderid and message are mandatory field that must have value for the API to work.
The sender id could be a number or letters or both but can not be more than 11 characters.
Example 1
https://www.domesms.com/sendsms.php?user=abc&password=xyz&mobile=0801XXXXXXX,0704XXXXXXX&group_id=1,2&senderid=SENDERID OR NAME&message=whatever it is but legal&unicode=1&schedule=yyyy:mm:dd:hh:mm:ss
Applying the field values from the table above as example you now have:
https://www.domesms.com/sendsms.php?user=chimuk&password=123456&mobile=08012345678,080xxxxxxxx&group_id=1,2&senderid=wedding&message=hi, happy birthday!&unicode=1&schedule=2016:10:28:14:20:10
If the field values above are to be valid ones ceteris paribus, the message, "hi, happy birthday!" will be delivered to the example mobile numbers and groups (08012345678,080xxxxxxxx&group_id=1,2) inputed above on 2016:10:28:14:20:10.
Example 2 (immediate delivery)
This: https://www.domesms.com/sendsms.php?user=chimuk&password=123456&mobile=08012345678,080xxxxxxxx&group_id=1,2&senderid=Wedding&message=hi, happy birthday!&unicode=1&schedule=
will be delivered immidiately now!
Balance Check
https://domesms.com/balance.php?user=xxx&password=yyy&action=send
API Response Codes
The following are the various response codes for success and failure:
1111:SUCCESS:SMS Submitted Successfully
1001:ERROR:Invalid URL
1005:ERROR:Invalid value in username or password field
1010:ERROR:Account expired
1015:ERROR:Insufficient SMS Credits
1020:ERROR:Invalid Sender
1025:ERROR:Invalid Schedule Time
1050:ERROR:Other error messages
1030:ERROR:Account doesn’t exist
1035:ERROR:Character count is greater than x
1040:ERROR:You are not allowed to Send Unicode Messages
1045:ERROR:Groups Not Found for Given Group Id(s)