Before you start! : 1. It is important to know some things code, before starting the deal with this file.

Transcription

1 Introduction: Do you have a special program you want linking it with the mobile messaging service SMS? We offer you in the SMS Mobily.ws service gate transmission API that lets you effortlessly connect your program or your site or your system regardless of the programming language used in your Application by our sms gateways to get distinctive message service, safe and reliable to high-linking it with your own system according to your data and your special specifications that done by yours programmers team.. All this through the pages of the Internet through the protocol HTTP. Before you start! : 1. It is important to know some things code, before starting the deal with this file. 2. In mobily.ws, and ensure that we mitigate the cost of the testing process, we offer a number of messages free trial when you open a new account. 3. When make a testing for the service we prefer to send a message later on, so that make you sure the message arrived to the messages in the temporary entry, you can review them through Mobily website on your account, then you can delete it and this will not deducted you re your balance. 4. When you send... You must type the numbers that you want send SMS to them as international without zeroes and without You can specify the name of the sender that messages will sent by it, with characters or numbers that must not exceed 11 characters. In case you want to send a message with mobile number as sender name, you need to activate this number before sending... You will find more details on the activation later. Features of Mobily.ws API: Using Mobily.ws API is very easy, through the forms that send data in the form By POST method, or sending the data through the URL by GET method. When you need to send large amounts of data in Mobily.ws we recommend using the first method POST, because the second method GET support a certain amount of data, so its cant capacity the largest amount of data sent through it.

2 When you contact Mobily.ws gateway through the HTTP protocol, we should Keep in mind, the sent data must equipped with an encoding required to have, for example, the name of the sender must be special to encrypt a URL-Encoded, and the text of the message should be encrypted is a special Unicode. Note regarding the name of the sender: when sending in the name of the sender, it must be adhered to the situation where the letters Lower Case or Upper Case, encoded by the URL-Encoded, i.e. as defined in Mobily.ws. Let s to start: For the use of sms gateway of Mobily.ws, it must obtain a special account from the site, with the following explanation of the registration process, as well as to view the balance and make recharge balance request through our website. The registration process: You can register online by accessing the following link: and then go to the page "Register now for free," and you will get free SMS credits directly and you can use the sender's name and password to send through the SMS gateway of Mobily.ws. The balance review and re-charging process : You can check your balance through the function in the balance Mobily.ws API, which found at the bottom of this document, you can also check your balance directly by accessing your account in mobily.ws login portal, and then go to sending sms page that displays the balance top of the page example 70/100, 100 that mean your balance overall, and 70 your current balance. Note: we deduct points based on the length of sent messages, and each point represents a message, the message length is calculated as follows: 1. Messages in English: the message length 160 characters (one point), if a message is sent in English with length of more than 160 characters, the length of the first message is 158 characters, and the second 158 characters, and so on Messages in Arabic: the message length 70 characters (one point), if a message was sent in Arabic with length of more than 70 characters, the length of the first message is 67 characters, and the second 67 characters, and so on... Application of recharge process: After logging in to your account in Mobily.ws, you can recharge your account, through the recharge link located in the menu right side, and then click on the link to show

3 you a set of commands, then select the command: add recharge request, and then fill in the form with required data in order to apply this request. Keep in mind that the balance will be charged within two hours at most, after verification of registration and data filled. Key processes through the API: Our gateway Provide many portals that serving sms functions like registration, and activating the name of the sender, transfer and recharge, and all portals consists of three main parts as follows: 1. The link to the portal. 2. User information, the user name and password. 3. Information requested from the gate. Examples: &sender=NEW%20SMS&msg= D006F C E &timeSend=0&dateSend=0 &applicationtype=24&domainname=localhost Explain the main gates of Mobily.ws: 1. Gate check the status of transmission at the site of Mobily The portal provides instant verification of the case of transmission at the site Mobily.ws, and the gate found at the following link: this portal do not receive any values. 1: You can send now. Otherwise: you cannot send now Gate to change the password Portal provides the ability to change the password for your account at the site of Mobily.ws, and the gate found at the following link: The portal receives the following values: 1. mobile : the name of the user. 2. password: old password.

4 3. newpassword: the new password. 2: The old password is wrong. 3: The process of changing the password was successful. newpassword= Gate to retrieve password Portal provides the possibility of recovering the password for your account at the site of Mobily.ws, and the gate found at the following link: The portal receives the following values: 1. mobile: the name of the user. 2. type: to specify where to send the password (1: to send the password on the mobile phone, 2: send the password on the , and must provide the correct address as part of personal information in your account information) 2: address of the account is not available. 3: the password has been sent to the mobile successfully. 4: your balance is not enough to complete the transmission. 5: send the password on the successfully. 6: address of the account is incorrect. 7: The user account name is incorrect. Examples: Balance Inquiry Portal provides service for balance inquiries at the site of Mobily.ws, and the gate located on the following link: The portal receives the following values: 1. mobile: the name of the user. 2. password: password.

5 If the values are correct query result will be a balance: on the following form, for example, 70/100, so that the current balance is 70 points, 100 balance of the client at the site. Set of values resulting from the use of this gate is wrong, and the meaning of each of 2: the wrong password Sending Portal provides transmission service through the site Mobily.ws, the gate is on the following link: 1. mobile: mobile number, which represents the user name (mandatory). 2. password: password (mandatory). 3. numbers: the number or range of numbers that will send sms to them (mandatory) and must be as international and without zeros or symbol (+), and is separated between each number with symbol (,), which is located right to M, keep in mind that the maximum number that can Send him during the time, only a number is sender: sender's name. Note: If the sending to the numbers of Saudi mobile networks, it must send through the active names only to you. 5. msg: the message body (mandatory), and must be a form of Unicode if you use old portals, cause in the new portal the conversion process is performed automatically, where the sending function converts the text to the required encryption. Note: In case you using the link directly, you must convert the text of the message to encrypt Unicode. 6. datesend: date of sending the message (optional), and this service offers the possibility of scheduling messaging to a specific date in order to send it, and you should be the following format mm: dd: yyyy. Note: If you do not need to this variable you can send a value of 0 or not to include it's in the variables sent, if send the value 0 or non-inclusion of this variable or in the case of a wrong date or old, before the date of sending the message, the message will be sent immediately. 7. timesend: time to send the message (optional), and this service offers the possibility of scheduling the transmission to a particular time in order to send it,

6 and you should be the following format hh: mm: ss. Notes: 1. If you do not need for this variable you can send a value of 0 or not to include among the variables sent. 2. If you are sending the value 0 or non-inclusion of this variable... at the same time you have set the variable datesend, the time to be adopted to send the message is at 00:00:00 on the date specified. 3. If you select the date of sending message, dated today, and the time for sending time prior to the time the current process, the message will be sent immediately. 8. deletekey: Delete key message (optional), and you can through this value, delete the message before it is sent from Mobily, this variable must hold a special value each entry is sent to the gate so that is linked to this figure the process of transmission which sent them, and therefore must use a different value in the process of sending, or messages will be deleted Gnia Altabah to figure this one off in the event has been used with more than one consignment. Notes: If you do not need for this variable you can send a value of 0 or not to include within the portal. 10. applicationtype: This value is fixed and equal (24), and must be passed with the values that are sent to the gate, this value represents the type of gate used in the transmission. 11. domainname: Site name (optional)... The name of the site that access the gate of transmission. -2: Not connect to server. -1: Not connect to the database. 1: message sent. 2: Balance = 0. 3: Balance is not enough. 4: Mobile number is not available. 5: wrong password. 6: Web Page is not effective Not Active, try posting again. 13: The name of the sender is not acceptable. 14: The name of the sender used in sending process is not defined. 15: recipient value is incorrect or empty. 16: The name of the sender is empty. 17: The text of the message is not encrypted properly.

7 Examples: Only the required values &sender=NEW%20SMS&msg= D006F C E &applicationType=24 all values &sender=NEW%20SMS&msg= D006F C E &timeSend=0&dateSend=0&deleteKey=4T &applicationtype=24&domainname=localhost sending later (at a specific time) &sender=NEW+SMS&msg= D006F C E &timeSend=17:30:00&dateSend=12/03/200 9&applicationType=24 Using deletekey with the send later, and the value of 4T to delete the message using the same value, through the gate to delete messages &sender=NEW+SMS&msg= D006F C E &timeSend=17:30:00&dateSend=21/03/200 9&deleteKey=4T&applicationType=24 6. Sending message using a template Portal provides service to send a message with a uniform template for different numbers, and the gate found at the following link: An example of transmission using a template for the message: Text message "template-general": hello Customer (1), the date of your subscription up to (2). When sending to a group of numbers is defined values specific to each number so that the compensation for the symbols (1) and (2) those values of numbers, this value is called msgkey. msgkey = "(1), *, (2), *, name2"; / / encrypt encrypted Unicode

8 Explanation of symbols: (1), (2), to denote symbols that must be compensated * between the desired symbol in the message and replaced by the value of separates the definition of the first symbol value and the second symbol and value. *** between the values of the first message and the values of the second message. Text message "General Template ": hello customer (1), the date of your subscription up to (2). msgkey: "(1),*,Mohammed,@,(2),*,12/10/2008***(1),*,Ahmed,@,(2),*,10/10/2008". Green: the values of the first message. Red: the values of the second message Numbers: the number of digits must equal the number of messages in msgkey, and therefore we will use two digits as the example: , Will get the message to the numbers as follows: No : hello your my brother Mohammed, the date of your subscription until 12/10/2008. No : hello your brother Ahmed, the date of your subscription until 10/10/ numbers. 4. sender. 5. msg. 6. datesend. 7. timesend. 8. deletekey. 9. msgkey: the set of values to offset for the text of the message, and must be in mind to the symbols used here, must match the codes used in the message body, as well as the number of values compensating for a single message must be equal to the number of symbols in the message body, as well as the number of sets of values countervailing must equal the number of digits. In the end, it's should be in Unicode format. 1: The transmission. 2: Balance = 0. 3: Balance is not enough.

9 4: Mobile number is not available. 5: wrong password. 6: There is a problem posting, and must try again later. 10: the number of digits is not equal to the number of messages. 13: The name of the sender is not acceptable. 14: The name of the sender used is not defined. 15: recipient value is incorrect or empty. 16: The name of the sender is empty. 17: The text of the message is not encrypted properly , , &sender=NEW%20SMS&msg=003F003F003F003F003F F003F F003F003F F F003F003F003F003F F003F003F0 03F003F003F003F F003F003F003F003F &dateSend=0&timeSend=0&msgKey = C002A002C003F003F003F003F002C C C A002C F F C002A002A002A002C C002A002C003 F003F003F003F002C C C002A002C F F C002A002A002A002C C002A002C003F003F003F003F003F002C C C002A002C F F &applicationType=24&domain Name=localhost 7. Delete messages Portal provides service to delete messages that send for later before it's time to send, and the gate found at the following link: Important note: this gate you delete messages through variable deletekey, and if not sent with this variable, it cannot be deleted through this portal. 3. deletekey: Delete key messages, the same value that was sent with the message. 1: the deletion was successful. 2: mobile number is not available. 3: the wrong password. 4: deletekey wrong.

10 8. Request mobile number as the name of sender in Mobily.ws: When you use the mobile number (which is not registered with it) as a sender in the transmission, this number must be licensed through our site, the portal provides the following service request license mobile number, which is found on the following link: / api / addsender.php, where is the activation process by sending the information necessary to this gate, The gate turn returns a numerical value as follows (# XXXX), that in order send this activation code as message to same mobile number. 3. sender: the sender's name to be licensed to be sent by "an international mobile number." 2: the wrong password. 3: The name of the sender "international code" is incorrect. 4: The name of the sender does not need to activate! 5: your balance is not enough to send the activation code. Sender ID: A numerical value you will need in the activation process, it s as follows: # 100 When used it in activation process its must remove the symbol '#' from the sender ID.

11 Activate mobile number as name of sender at the site of Mobily.ws: Portal provides service to activate name of the sender (mobile number), which was requested at the gate "Request sender as mobile number as previous gate," and the gate is on the following link: 3. senderid: numerical value from the process of requesting a license and should be sent without the symbol '#'. 4. activekey: activation code, which was received on the mobile number to be licensed as the name of the sender. Set of values resulting from the use of this Portal 2: wrong password. 3: The activation of the name of the sender is done. 4: The activation code is incorrect. 5: senderid wrong. &activekey= Verification the licensing status of mobile number as the name of sender in Mobily.ws: Portal provides the service of verification the licensing status of the name of sender (mobile number), and you can use it after the Activation application, to verify the status of the request first, and the gate is on the following link: 3. senderid: numerical value of feedback from the process of recording without the sender's name and symbol'#'... 0: the name of the sender is not verified.

12 1: the name of the sender is verified. 2: Name of Sender Denied "activation code for the sender was sent 3 times wrong." 3: mobile number is not available. 4: wrong password. Important notes regarding licensing mobile number as the name of sender: 1. Licensing process of mobile number as name of sender is used only once for each new number, if repeating the process of licensing to the same mobile number more than once, cause disabling use of this number as name of sender and will be not license it to verify the ownership of the number. 2. When licensing mobile number as the sender name, take the following example: It s will be activated as Request name Alphabet as the name of the sender in Mobily.ws: When you use the name of the sender (character with numbers ) as a sender in the transmission process, this name must be licensed through our site, the portal provides the following service to request license Sender ID, which is found on the following link: 3. sender: the sender's name to be licensed. Set of values resulting from the use of this Portal 2: wrong password. 3: The length of the sender's name to be greater than 11 charactars. 4: The request of sender has been added successfully.

13 ndername1 12. Verification the licensing status of name Alphabet as the name of sender in Mobily.ws: Portal provides the service of verification for licensing of Sender ID, as well as check the status of all the names of the sender (the name of the sender as mobile number and or name of the sender as characters, same steps), and the gate found at the following link: / checkalphassender.php Set of values resulting from the use of this Portal 2: the wrong password. 3: [pending] [active] [notactive] after each value of the total senders, these values indicate the following: a. pending, names of the sender is waiting for the license mobily, and you can t send by them now. b. active, names of the senders have been licensed from mobily, and you can send by them now. c. notactive, names of the sender is rejected directly from the site of mobily, so you can not send by them now.