REST API
https://www.isms.com.my/RESTAPI.php
Parameters
Property name |
Type |
Description |
Sample |
un |
String |
Username of iSMS account. |
|
pwd |
String |
Password of iSMS account. |
|
dstno |
String |
Destination addresses must be in international format (example: 60164502380). |
60164502380 |
msg |
String |
Text of the message that will be sent. |
|
type |
Integer |
Type of SMS
1. ASCII (English, Bahasa Melayu, etc)
2. Unicode (Chinese, Japanese, etc)
|
1 |
agreedterm |
String |
Agreed iSMS Term and Condition below:
https://www.isms.com.my/user-agreement.php
API will filter your sms if you do not agreed with the agreement.
|
Yes |
sendid |
String |
Represents sender ID and it can be alphanumeric or numeric. Alphanumeric sender ID length should be between 3 and 11 characters (example: CompanyName).
|
|
Server Response
Return Values :- Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message.
If the SMS has been successfully sent, you'll get a response like below :-
2000 = SUCCESS:trx_id
However, if the SMS is failed, you'll get a error code and error description like below :-
-1004 = INSUFFICIENT CREDITS
Error Code |
Error Description |
Details |
2000 = SUCCESS:trx_id |
SUCCESS push SMS to telco, trx_id is unique SMS ID. |
Message Sent. |
-1000 |
UNKNOWN ERROR |
Unknown error. Please contact the administrator. |
-1001 |
AUTHENTICATION FAILED |
Your username or password are incorrect. |
-1002 |
ACCOUNT SUSPENDED / EXPIRED |
Your account has been expired or suspended.
Please contact the administrator. |
-1003 |
IP NOT ALLOWED |
Your IP is not allowed to send SMS.
Please contact the administrator. |
-1004 |
INSUFFICIENT CREDITS |
You have run out of credits.
Please reload your credits. |
-1005 |
INVALID SMS TYPE |
Your SMS type is not supported. |
-1006 |
INVALID BODY LENGTH (1-700) |
Your SMS body has exceed the length.
Max limit = 700 |
-1007 |
INVALID HEX BODY |
Your Hex body format is wrong. |
-1008 |
MISSING PARAMETER |
One or more required parameters are missing. |
-1009 |
INVALID DESTINATION NUMBER |
Invalid number |
-1012 |
INVALID MESSAGE TYPE |
Message contain unicode and please use type=2 for Unicode |
-1013 |
INVALID TERM AND AGREEMENT |
Please add agreedterm=YES in your API |
Download Sample PHP File