You can interface an application, website or system with our messaging gateway by using our very flexible HTTP API connection. Once you're connected, you'll be able to deliver messages.
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)