|
Note on HTTP connections: please limit yourself to
one concurrent connection, i.e., in your code, send with
only one thread/process.
Please do not call us for
implementing XML API at your end in different programming
languages. We are not providing any help regarding
implementation of XML API at user end. If, you found any
bug please send the details at info@zni.co.in.
URL (Single or Group SMS):
http://api.znisms.com/post/xmlsmsv3.asp
Format:
<?xml version='1.0'
encoding='ISO-8859-1' ?>
<push>
<from>userid$apikey</from>
<gsm>any_id</gsm>
<cdma>gsm_mobile_no</cdma>
<message><![CDATA[message]]></message>
<mobileno>
<nos>9935555512</nos>
<nos>919935555512</nos>
<nos>919935555512</nos>
<nos>9935555512</nos>
<nos>9935555512</nos>
</mobileno>
</push> |
- userid: your ZNI username
- API Key: your ZNI API
KEY(Please
note $ (dollar) sign between userid and password). You
can get it from support
- message: max 160 chars for text.
Please put the data in between of CDATA tags only.
- gsm: mobile no. or name (Max. 11
characters) from which you want to send SMS. (we do
not recommend alphanumeric sender id as many of
operators doesn't support this feature, so your
account will be charged without delivering the
message). This ID will be sent to all GSM mobiles e.g.
Airtel, BSNL, Idea, Hutch, Orange, BPL, AirCel etc
- cdmaid: Your GSM mobile number. This
ID will be sent to CDMA numbers like Reliance and
TATA. (10 digit only).
- nos: These are the destination numbers on
which you want to send SMS.
* SandBox URL can be used for testing purpose
i.e. to check how our API will respond to your queries
without utilizing any credits from your account. It's a
dummy API with all the functionalities of the original URL
but you can't send SMS from this.
For Sandbox testing please use userid and password as
temp$temp.
Returns:
<?xml version='1.0'
encoding='ISO-8859-1' ?>
<receipt>
<response>
<mob>destination_mobile_no1</mob>
<msgid>system_generated_id1</msgid>
</response>
<response>
<mob>destination_mobile_no2</mob>
<msgid>system_generated_id2</msgid>
</response>
<error>Error Message</error>
</receipt> |
Possible values for Error Messages are:
- 20: Account Locked
- 21: Account Expired
- 23: Authentication failure
- 24: Data validation failed
- 25: You do not have sufficient credits
- 40: Temporarily unavailable
- 50: Message submitted to SMSC for delivery.
Note: you should attempt to resend if you receive
status code 40. You could also do so if you receive 26 or
28, which might have been resolved after several resend
attempts. All other errors should be considered fatal.
Any HTTP status code other than 200 should be
considered transient, i.e. you should attempt to resend
after some interval.
Limitations:
- SMS can't be send on a CDMA with a
alphanumeric senderid
- SMS cant't be send on a Reliance India Mobile from
another Reliance India Mobile number
- All PDU (binary) format SMS are blocked currently or
may charged more then one SMS credit i.e. you can't
send Ringtones, Operator Logos,
Picture Message from this API.
- Only 70 characters allowed in a flash message.
- Do not use any mobile
number as a sender id (CLI) for GSM mobiles as it is
not allowd as per TRAI notificaion.
NOTE: While using 10 digit no as a sender ID, Please
keep in mind that it should be a valid mobile number and should
be owned by you. We will not take any guarantee of
delivery if, the number used in the sender id field is not
a valid number.
Please note these limitations are imposed by the SMSC
and not by us.
|
