Resalty API User Manual

November 2010

Copyright 2010 Resalty.Net All rights reserved.

Introduction

3 Introduction 3 HTTP SMS API 3 Why use Resalty API?

How To Use Sending queries

Registration

5 Sending process 7 Sending query 8 Balance query

Support

9 Help

3 1-1 Introduction
Resalty.Net is the leading mobile messaging services and solutions provider through Internet in Middle East. *** This manual for users who want to know how to use Resalty API for sending SMS from There applications.

1-2 HTTP SMS API

Resalty API enables you to send SMS to your customers, friends or relatives whenever and wherever they are, directly through your applications (Website or Programs).

1-3 Why use API?

Quick and easy way to send your messages from your application. Building programs and specialized in advanced solutions growing market of SMS. Can be integrated with any system quickly and easily.

4
2-1 Registration
To be able to use Resalty API you must register with us; you can register for free through this link "here" and then follow the following steps to complete the registration: After clicking the link above, will show you the registration page enter your complete details. Then press "Register. Activation code will be sent to activate the account to the mobile that you registered with. Enter the activation code into activation page and click "activate". You can now use your account and test sending through the free 10 SMS as a gift to you.

5
3-1 Sending Process
This solution enables you to send SMS to receiver mobiles via your application, to send by this way you can following these steps: 1- Replace each variable with suitable values and open the following link via the browser or any other programming language. http://www.resalty.net/api/sendSMS.php?userid=YouUser&password=You rPassword&to=MobileNumber&msg=Message&sender=SenderName&enc oding=utf-8 2- List of variables Variable Name YourUser (Required) YourPassword (Required) MobileNumber (Required)
(Numeric) (Numeric/Alpha Numeric)

Variable Values
(Numeric/Alpha Numeric)

Description Your User Name in Resalty.Net Your Password in Resalty.Net Mobile number you want to send to, you can use comma (,) to send to several numbers The message text you want to send The name will appear as sender with your message The language used in message text

Disallowed Values Non-English characters

_____

00 or + before the numbers

Message (Required) SenderName (Required) Encoding

(Numeric/Alpha Numeric)

You can use all languages character Its must be added in your account, and not exceed 11 char or 16 number &encoding=utf-8 for Arabic and other Unicode Content languages Messages. Remove &encoding=utf-8 for English Content Only.

(Numeric/Alpha Numeric)

(Static)

6
*** After using the variables above, you can open the link to try sending.

3- List of successful responses Response Error : 0 MessageID : xxx Description Your message has been received to API successfully

4- List of other responses Response Error : General Wrong API calling (One or more of variables were entered incorrectly) Error: wrong API parameter for [type]... (There is a variable doesnt exist in the system) Error: Wrong API parameter(s) for [send] (You have entered a wrong content in the link) Error: Username or password is incorrect or you don't have the permission to use this service Error: Sender name must not exceed 11 characters or 16 numbers Error: The receiver number must be consist of numbers only without + Error: Sender name must be in English letters only Error: You cannot send to this amount at the same time, please divide this messaging to many groups Error: It is not allowed to use sender name you have entered, please choose another one Error: The message content you want to send is not allowed If you think this is error, please contact technical support ... Error: You have not enough balance to send this message

3-2 Sending query

You have sending through Resalty API, now you want to know the message status (Sent successfully, Failed or Still Sending), to send a status query follow these steps:

1- Replace the variables in this following link with the suitable values, and then open it via the browser or any other programming language. http://www.resalty.net/api/msgQuery.php?userid=YourUser&password=Y ourPassword&msgid=MessageID 2- List of variables Variable Name YourUser (Required) YourPassword (Required) MessageID (Required) Variable Values (Numeric/Alpha Numeric) (Numeric/Alpha Numeric) (Numeric/Alpha Numeric) Description Your User Name in Resalty.Net Your Password in Resalty.Net Message ID you have received Disallowed Values Non-English characters _____ _______

3- List of responses Response STATUS05: The message has been sent successfully STATUS01: The message is on the send queue STATUS02: The message has been failed STATUS03: The message has been rejected STATUS04: The message has been stopped The message has been stopped Error : Wrong API parameter in msgid for [query] Error : Wrong API parameter(s) for [query]

8
3-3 Balance query
If you want to know your balance after sending SMS, you can follow these steps: 1- Replace the variables in this following link with the suitable values, and then open it via the browser or any other programming language. http://www.resalty.net/api/getBalance.php?userid=YouUser&password=YourP assword 2- List of variables: Variable Name YourUser (Required) YourPassword (Required)
(Numeric/Alpha Numeric)

Variable Values
(Numeric/Alpha Numeric)

Description Your User Name in Resalty.Net Your Password in Resalty.Net

Disallowed Values Non-English characters

_____

3- List of responses Response Number Error : Wrong API parameter(s) for [balance] Error : Wrong API authentication for [balance] Description The number of credits you have in your account There is a wrong content in the link You have not a permission to or your account info is incorrect

9
4-1 Help
Resalty.Net Team is pleased to receive your questions, comments & suggestions in all of our services and solutions, and we are pleased to be in touch with you at the following addresses:

Head Quarter

Al Khobar KSA Prince Turkey Road (Al Korniche) - Al Moussa Complex (Al Obaikan Library) First Floor Office 107 P.O Box: 2689 Al Khobar 31952

Fax: Tel:

0096638814820 00966920002687

Sales: E-mail: salesdpt@resalty.net Technical Support: E-mail: support@resalty.net

END

Copyright 2010 Resalty.Net. All rights reserved.