Napishi.Ru / Program interfaces (API) for sending SMS, telegrams, letters etc. - Send SMS (text), telegrams, 'paper' letters, fax and telex messages in any country via internet. Hybrid mail system.

Send:
Letter
Telegram
FAX
Telex
SMS

How to pay

Sponsors

Advertise on this site

Support us

Guestbook

Publications

Program interfaces (API) for sending SMS, telegrams, letters etc.

Below is the description of HTTP/XML interfaces for sending messages via Napishi.Ru. XML-requests should be POSTed to URL=http://www.napishi.ru/extxml.asp, server will also respond with XML, containing <result> - "OK" or "ERROR".
    Addition: due to numerous requests from webmasters now messages can be sent with HTTP-GET method, with parameters, appended to url.
    You need to have positive balance to send messages via this XML-interface. Look for tariffs here.
    Examples are available below.

Parameter name	Parameter description
Parameters for any request
user	Login of the registered user
[pwd]	Cleartext password
[pwdhash]	MD-5 hash of password (use instead of pwd)
command	send - Sends the message. status - Returns status of the message, sent earlier. balance - Returns your account balance in USD. price - Calculates the price of the given message. All parameters are the same as in "send" command. cancel - Cancel message (if possible). All parameters are the same as in "status" command. delete - Delete message (if possible). All parameters are the same as in "status" command.
Parameters for command=status
order_id	Order number
Parameters for command=send
product_id	1 - Letter 2 - Telegram 3 - Fax 4 - Telex 5 - SMS
message_body	Message text
[debug]	If not empty, the message will not be actually sent, instead of that user will receive back an email message with gebug info inside.
[schedule]	Date and time in "yyyyMMdd hh:mm" format. If given, the message will be scheduled.
[postback_url]	URL, to that would be sent a notification, that message got a "final" status. Notification will be POST'ed as XML. Also can be a valid email address (instead of URL) - to get notified by email instead of POSTing.
Parameters for command=send & product_id=5 (SMS)
[phones]	Full recipient phone number, starting with country code. If not empty, you need not assign parameters country_code, area_code and phone_no.
[rus_sms]	If not empty, message text WILL NOT be autoconverted to "translit". Translit - cyrillic letters encoded with latin symbols. Used, when recipient's device does not display cyrillic letters correctly.
[source_phone_no]	Sender's phone number (or text). Up to 15 digits or up to 11 other symbols - digits, punctuation marks and latin letters. If empty, "Napishi.Ru" will be used.
[source_confirmed]	Confirmation, that [source_phone_no] really belongs to sender, and sender can proof that fact.
Parameters for command=send & product_id=4 (Telex)
full_telex_no	Full recipient's telex number, including country code.
Parameters for command=send & product_id=3 (Fax)
country_code	Country code
area_code	Area or mobile operator code
phone_no	Recipient's fax number
Parameters for command=send & product_id=2 (Telegram)
country_code	Standatd 2-letter country code. "RU" for Russia.
city_address	City.
street_address	Street address.
recipient_name	Recipient name.
signature	Signature (sender's name)
[urgent]	Urgency attribute, applicable to Russia only. If given, telegram will be treat as "urgent".
Parameters for command=send & product_id=1 (Letter)
to_country_code	Standatd 2-letter country code. "RU" for Russia.
[to_zipcode]	Zipcode
[to_region]	Addressee region (area, state etc.)
to_city_address	Addressee city.
to_street_address	Addressee street address
to_name	Addressee name
[to_company]	Addressee company name
from_country_code	Standard 2-letter sender's country code. "RU" for Russia.
[from_zipcode]	Sender's zipcode
[from_region]	Sender's region (area, state etc.)
[from_city_address]	Sender's city.
[from_street_address]	Sender's street address.
from_name	Sender's name.
[from_company]	Sender's company.
[picture_url]	URL of the picture to print

Examples:

Sending SMS. Server returns order number and it's price.	Request to server (XML, POST): <?xml version="1.0" encoding="windows-1251"?> <request> <user>valid@username</user> <pwd>valid_password</pwd> <command>send</command> <product_id>5</product_id> <country_code>7</country_code> <area_code>903</area_code> <phone_no>1234567</phone_no> <message_body>привет</message_body> </request>
	Request to server (URL, GET): http://www.napishi.ru/extxml.asp? user=valid@username& pwd=valid_password& command=send& product_id=5& country_code=7& area_code=903& phone_no=1234567& message_body=%EF%F0%E8%E2%E5%F2
	Response from server: <?xml version="1.0" encoding="windows-1251"?> <response> <result>OK</result> <order_id>18518</order_id> <price>0.06</price> </response>
Sending scheduled fax message. Sinse password is incorrect, server returns the error.	Request to server (XML, POST): <?xml version="1.0" encoding="windows-1251"?> <request> <user>valid@username</user> <pwd>invalid_password</pwd> <command>send</command> <product_id>3</product_id> <country_code>7</country_code> <area_code>095</area_code> <phone_no>1234567</phone_no> <message_body>test fax message</message_body> <schedule>20050521 23:22</schedule> </request>
	Request to server (URL, GET): http://www.napishi.ru/extxml.asp? user=valid@username& pwd=invalid_password& command=send& product_id=3& country_code=7& area_code=095& phone_no=1234567& message_body=test+fax+message& schedule=20050521+23%3A22
	Response from server: <?xml version="1.0" encoding="windows-1251"?> <response> <result>ERROR</result> <errorDescription>Bad password pwd</errorDescription> </response>
Requesting status of fax, that was sent earlier. Instead of plaintext password it's MD5-hash was given.	Request to server (XML, POST): <?xml version="1.0" encoding="windows-1251"?> <request> <user>valid@username</user> <pwdhash>valid_MD5_password_hash</pwdhash> <command>status</command> <order_id>17646</order_id> </request>
	Request to server (URL, GET): http://www.napishi.ru/extxml.asp? user=valid@username& pwdhash=valid_MD5_password_hash& command=status& order_id=17646
	Response from server: <?xml version="1.0" encoding="windows-1251"?> <response> <result>OK</result> <order_id>17646</order_id> <price>0.24</price> <status>20</status> <statusDescription>Paid, queued for sending (F)</statusDescription> </response>

You can download script (.vbs) examples, that uses XML-interfaces, described above.

Last polls results

You are here: Napishi.Ru / Program interfaces (API) for sending SMS, telegrams, letters etc.