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 or check your balance.
The API Parameters and What They Stand For:
API NAME: Empire BulkSMS
1. recipient : The destination phone numbers. Separate multiple numbers with comma(,)
3. username: Your empiresms.com account username
4. password: Your empiresms.com account password
5. sender: The sender ID to show on the receiver's phone
6. message: The text message to be sent
7. balance: Set to true only when you want to check your credit balance
6. schedule: Specify this parameter only when you are scheduling an sms for later delivery. It should contain the date the message should be delivered. Supported format is "2009-10-01 12:30:00" i.e "YYYY-MM-DD HH:mm:ss"
HTTP API Configuration
HTTP API:
http://www.empiresms.com/index.php?option=com_spc&comm=spc_api&username=user&password=1234&sender=@@sender@@&recipient=@@recipient@@&message=@@message@@&
HTTP API(SPC3 Format):
http://www.empiresms.com/components/com_spc/smsapi.php?username=user&password=1234&sender=@@sender@@&recipient=@@recipient@@&message=@@message@@&
API to Check Your Bulk SMS Balance:
http://www.empiresms.com/index.php?option=com_spc&comm=spc_api&username=user&password=1234&balance=true
API to Check Your Bulk SMS Balance(SPC3 Format):
http://www.empiresms.com/components/com_spc/smsapi.php?username=user&password=1234balance=true
API Response confirmation: Contains
The return values are
OK=Successful
-2904=SMS Sending Failed
-2905=Invalid username/password combination
-2906=Credit exhausted
-2907=Gateway unavailable
-2908=Invalid schedule date format
-2909=Unable to schedule
-2910=Username is empty
-2911=Password is empty
-2912=Recipient is empty
-2913=Message is empty
-2914=Sender is empty
-2915=One or more required fields are empty
Example:
On success, the following code will be returned
OK 21 08033333333,08022222222,08055555555
i.e OK no of sms credits used gsm numbers that failed
where 21=no of sms credits used and 08033333333,08022222222,08055555555 are the 3 numbers that failed