Mobi-Magic API Codes

advertisement
HTTP API
API single message to single recipient
http://sms.smsforbulk.com/api/pushsms.php?usr=your profile id&pwd=your
password&sndr=Sender id&ph=destination mobile number&text=Text message&rpt=1
Example Url
http://sms.smsforbulk.com/api/pushsms.php?usr=12345&pwd=mypasss&sndr=WBSMS&ph=98
00000000&text=Test sms from API&rpt=1
Output
100 Message Sent. trackid: E1d574F1-F279-F252-9517-05D156E66
Numbers Processed:1
Invalid Numbers:0
Duplicate Numbers:0
NDNC Numbers:0
Valid Numbers:1
API single message to multiple recipients
http://sms.smsforbulk.com/api/pushsms.php?usr=your profile id&pwd=your
password&sndr=Sender id&ph=mobile1,mobile2,mobile3&text=Text message&rpt=1
Example Url
http://sms.smsforbulk.com/api/pushsms.php?usr=your profile id&pwd=your
password&sndr=Sender id&ph=9810000000,9891000000,9300000000&text=Text
message&rpt=1
Output
100 Message Sent. trackid: KLS574F1-G7f9-A294-9517-05Dy7DC6T61
Numbers Processed:2
Invalid Numbers:0
Duplicate Numbers:0
NDNC Numbers:0
Valid Numbers:2
……………………………………………………………………………………………
API - Schedule Sms
http://sms.smsforbulk.com/api/pushsms.php?usr=your profile id&pwd=your
password&sndr=Sender id&ph=destination mobile number&text=Text
message&time=1236299296 (Time In seconds from 1 Jan 1970)rpt=1
…………………………………………………………………………………………….
API – Unicode Sms
http://sms.smsforbulk.com/api/pushsms.php?usr=your profile id&pwd=your
password&sndr=Sender id&ph=9810000000,9891000000,9300000000&text=Text
message&rpt=1&type=1
…………………………………………………………………………………………….
API - Credit balance status
http://sms.smsforbulk.com/api/balance.php?usr=your profile id&pwd=your password
……………………………………………………………………………………………
API – Password Change
http://sms.smsforbulk.com/api/pwd.php?usr=your profile id &pwd=Your current
password&new=your new password.
HTTP Report API
API for single report against unique reqid
http://sms.smsforbulk.com/api/pullreport.php?usr=12345&pwd=xyz&reqid=0861C457-1384269D-CDA2-A706F70B0CD0&sr=1
……………………………………………………………………………………………………...
API for multiple reports against unique reqid
http://sms.smsforbulk.com/api/pullreport.php?usr=12345&pwd=xyz&reqid=0861C457-1384269D-CDA2-A706F70B0CD0&sr=1,2,3,6,12,55
……………………………………………………………………………………………………...
Output
For Single mobile number report
Delivered#2009-01-11 15:06:42,
For multiple mobile number reports
Delivered#2009-07-11 15:06:42,
Failed#2009-07-11 15:06:36,
Delivered#2009-07-11 15:06:44,
Delivered#2009-07-11 15:06:43,
NDNC#2009-07-11 15:06:44,
HTTP API Parameter Details
Parameter
usr
pwd
sender
ph
text
rpt
type
time
Description
Your account profile id
Your account password
Sender Id
Mobile number of the recipient(s).
Your Text message
This parameter have your, ( rpt=1 as enable) If you wish to Track the delivery
status of the message then send value as 1 e.g. rpt=1
This parameter has the specific message type like Unicode message/ flash
message. If you wish to send the message which should flash directly on
the screen of mobile then send type value as 1 e.g. type=1 or If you wish
to send sms which content Unicode character(s) then send type value as 2 e.g.
type=2 Note: 70 Unicode characters makes 1 sms
This parameter has schedule time for post (later) auto delivery on future time.
e.g. time=201212010930 ( Date: 2012 12 01 & Time: 09.30 AM ) Note: Time
Binary
Sr
can be send in 24 hours format with correct Date of future, schedule cant be
set more than 3 months from the date of request time while you send sms by
API.
If you wish to send binary sms then send value of binary as 1 e.g. binary=1
This parameter has the sequence number of any mobile number against each
Request id. Numeric value for more than one number in any sequence against
each request id. e.g sr=1 or sr=1,2,3,12,14 ( if recipient is more than one )
HTTP API Reply Code Description
Reply Code
100
Reply Message
Message Sent.
trackid: E1d574F1-F279-F2529517-05D156E66
Description
Your message has been submitted
with track id & queued for
outbound SMSC.
150
Message Sent
Your message has been submitted
& queued for outbound SMSC.
200
Authentication Failure
Invalid User name / Password
350
No More Credits/Expired A/c
Contact your provide Expired
Insufficient Balance / Account
600
Invalid Sender Id
Unauthorised Sender Id
500
Blank Message!
No text in message.
700
No recipient mobile No
No destination / mobile number
800
Message Scheduled
Message Scheduled
400
Unicode Message but type value
is not set to 1
Specific message type
900
NDNC
Number Registered In NDNC
Download