المقدمة:

هل لديك برنامج خاص ترغب بربطه مع خدمة رسائل الجوال SMS ؟
نقدم لك في رسائل الجوال , وهي خدمة بوابة الإرسال API التي تمكنك بكل سهولة من ربط برنامجك أو موقعك أو نظامك أياً كانت لغة البرمجة المستخدمة فيه ببوابات الإرسال الخاصة بنا لتحصل على خدمة رسائل نصية قصيرة SMS مميزة وآمنة وذات موثوقية عالية لتربطها مع نظامك الخاص وفق معطياتك ومواصفاتك الخاصة التي يقوم فريق المبرمجين الخاص بك ببرمجته ..كل هذا من خلال صفحات انترنت من خلال بروتوكول HTTP.

قبل البدء!:

  1. من المهم الدراية ببعض الأمور البرمجيه، قبل البدأ بالتعامل مع هذا الملف.
  2. في البرنامج، وحرصا منا على تخفيف تكاليف عملية الفحص، فإننا نقدم عددا من الرسائل التجريبية المجانيه عند فتح حساب جديد.
  3. عند عمل الفحص يفضل إرسال رسالة بتاريخ وقت لاحق، بحيث تتأكد من وصل الرسالة إلى الرسائل المؤقتة من خلال الدخول على حسابك بالموقع، وبعدها يمكنك حذفها وبهذا لن تخصم من الرصيد.
  4. عند الإرسال.. يجب كتابة الأرقام المرسل لها بالصيغة الدولية بدون أصفار وبدون + .
  5. يمكنك تحديد اسم المرسل الذي ترسل رسائلك به وهو عبارة عن أحرف أو أرقام على أن لايتجاوز 11 خانة. وفي حال رغبتك بإرسال رسالة بإسم مرسل رقم جوال فإنك بحاجة لتفعيل هذا الرقم قبل الإرسال ..ستجد مزيد من التفاصيل عن التفعيل لاحقاً.

 

ميزات API:

الإتصال ببوابة سهل جداً ، وذلك من خلال النماذج forms والتي ترسل البيانات على شكل POST، أو بإرسال البيانات من خلال URL بحيث تكون على شكل GET.
عند الحاجة لإرسال كميات بيانات كبيرة نوصي في البرنامج بإستخدام الطريقة الأولى POST ، وذلك لأن الطريقة الثانية GET  تدعم حد معين من البيانات، وقد تكون كمية البيانات المرسلة أكبر منها .

عند الإتصال بالبوابات عن طريق البروتوكول HTTP بجب الإنتباه إلى أن تكون البيانات المرسله، مجهزة على الترميز المطلوب لها، ومثال ذلك، إسم المرسل يجب أن يكون على تشفير خاص وهو URL-Encoded، وكذلك نص الرساله يجب أن يكون على تشفير خاص هو Unicode.

ملاحظه بخصوص إسم المرسل: عند الإرسال بإسم المرسل المعرف، فإنه يجب التقيد بحالة الحروف من حيث Lower Case  أو Upper Case، قبل تشفيرها إلى URL-Encoded، أي كما تم تعريفه في الموقع.

دعنا نبدأ:

http://getway.uaedes.ae/sendurlcomma.aspx?user=xxxxxxxx&pwd=xxxxxx&senderid=SMSAlert& mobileno=mobileno,mobileno&msgtext=Hello&priority=High&CountryCode=ALL

For sending multiple Single/Multiple SMS use the above API Glossary of dynamic fields:

profileid = You will get a unique profile id once your account is logged in. It will be a 8 character numeric id (200XXXXX).

password = Password will be the part of credentials provided to you. You can change them innumerable times

ABC = This will be the approved Sender ID from the operator. User can have multiple approved Sender IDs & can use any of them. In case, the sender ID doesn’t match with the approved ones, SMS will go from the default ID

mobileno = The UAE mobile no. to which user wants to send SMS. They can be in any format (+9715XX, 9715XX, 05XX, 5XX). Only numbers are allowed. System will automatically reject less than 9 digit & nos. not starting with 5.

Hello = The SMS content. 160 English characters counted as 1 SMS. 70 Unicode characters counted as 1 SMS. If SMS length is more than 1 SMS than the SMS counts are in multiple of 153 in case of English & 63 in case of Unicode.

Check balance :

http://getway.uaedes.ae/balance.asp?user=profileid&pwd=password

profileid = Use your 8 digit profile id & password to check your balance SEND SMS WITH ADVANCE OPTIONS:

http://getway.uaedes.ae/sendurlcomma.aspx?user=xxxxxxxx&pwd=xxxxxx&senderid=SMSAlert& mobileno=mobileno,mobileno&msgtext=Hello&priority=High&CountryCode=ALL&scheduledDate= mm/dd/year hh:min am

*NOTE * Parameter scheduledDate=mm/dd/year hh:min am has to be used only for sms scheduling using api.

Glossary of dynamic fields:

profileid = You will get a unique profile id once your account is logged in. It will be a 8 character numeric id (200XXXXX).

password = Password will be the part of credentials provided to you. You can change them innumerable times

ABC = This will be the approved Sender ID from the operator. User can have multiple approved Sender IDs & can use any of them. In case, the sender ID doesn’t match with the approved ones, SMS will go from the default ID

mobileno = The UAE mobile no. to which user wants to send SMS. They can be in any format (+9715XX, 9715XX, 05XX, 5XX). Only numbers are allowed. System will automatically reject less than 9 digit & nos. not starting with 5.

Hello = The SMS content. 160 English characters counted as 1 SMS. 70 Unicode characters counted as 1 SMS. If SMS length is more than 1 SMS than the SMS counts are in multiple of 153 in case of English & 63 in case of Unicode.

scheduledDate=This will be the date time on which message has to be sent.This version of api is only used for SMS scheduling. SEND SMS WITH ADVANCE OPTIONS With UNICODE:

http://getway.uaedes.ae/sendurlcomma.aspx?user=xxxxxxxx&pwd=xxxxxx&senderid=SMSAlert& mobileno=mobileno,mobileno&msgtext=Hello&priority=High&CountryCode= ALL&language=Unicode

profileid = You will get a unique profile id once your account is logged in. It will be a 8 character numeric id (200XXXXX).

password = Password will be the part of credentials provided to you. You can change them innumerable times

ABC = This will be the approved Sender ID from the operator. User can have multiple approved Sender IDs & can use any of them. In case, the sender ID doesn’t match with the approved ones, SMS will go from the default ID

mobileno = The UAE mobile no. to which user wants to send SMS. They can be in any format (+9715XX, 9715XX, 05XX, 5XX). Only numbers are allowed. System will automatically reject less than 9 digit & nos. not starting with 5.

Hello = The SMS content. 160 English characters counted as 1 SMS. 70 Unicode characters counted as 1 SMS. If SMS length is more than 1 SMS than the SMS counts are in multiple of 153 in case of English & 63 in case of Unicode.

*NOTE * For using parameter language=Unicode the sms content has to be sent as hexadecimal.

API #

http://getway.uaedes.ae/sendurlcomma.aspx?user=profileid&pwd=password&senderid=ABC&mo bileno=mobileno&msgtext=Hello&CountryCode=ALL&scheduledDate=mm/dd/year hh:min am

Sample Codes

ASP #
sResponse = SMSSend(pno, message )
If right(sResponse,15) = "Send Successful" Then
'write your code here End If Function SMSSend (strPh,strMsg) Dim msgResponse Dim strRequest
Dim strUrl
msgResponse = ""
strPh=right(strPh,10)
If not IsNumeric(strPh) Or len(strPh) <> 10 Then
msgResponse = "Enter valid Mobile Number."


End If
If strMsg = "" Then
msgResponse = "Enter text message."
End If
strUrl = "http://getway.uaedes.ae/sendurlcomma.aspx?"
strRequest = strRequest+"user=profileid"
strRequest = strRequest+"&pwd=pass"
strRequest = strRequest+"&senderid=senderid"
strRequest = strRequest+"&mobileno="+strPh
strRequest = strRequest+"&msgtext="+Server.URLEncode(strMsg)
strRequest = strRequest+"&CountryCode="ALL
strUrl = strUrl+strRequest
If msgResponse = "" Then
Dim oXML
Dim sPage
Err.Clear
On Error Resume Next
Set oXML = Server.CreateObject("Msxml2.XMLHTTP")
oXML.Open "get", strUrl , false
oXML.Send
msgResponse = oXML.ResponseText
Set oXML = Nothing
End If
SMSSend = msgResponse
If Err.Number <> 0 Then
SMSSend = "Problem on sending sms : "& Err.Description
End If
End Function
ASP .NET (C#)
using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.IO;
using System.Net;
public void SMSSend()
{
WebClient client = new WebClient();
string baseurl = "http://getway.uaedes.ae/sendurlcomma.aspx?user=profileid&pwd=xxxx&senderid =ABC&mobileno=9911111111&msgtext=Hello&CountryCode=ALL&scheduledDate =mm/dd/year hh:min am";
Stream data = client.OpenRead(baseurl);
StreamReader reader = new StreamReader(data);
string s = reader.ReadToEnd();
data.Close();
reader.Close();
}

JAVA #
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

import java.util.Date;
public class SMSSend {
public static void main(String[] args)
{ try {
Date mydate = new Date(System.currentTimeMillis());
URL url = new
URL(http://getway.uaedes.ae/sendurlcomma.aspx?user=profileid&pwd=xxxx&send erid=ABC&mobileno=9911111111&msgtext=Hello&CountryCode=ALL&scheduled Date=mm/dd/year hh:min am);
HttpURLConnection conn = (HttpURLConnection)url.openConnection(); conn.setRequestMethod("GET");
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setUseCaches(false);
conn.connect();
BufferedReader rd = new BufferedReader(new
InputStreamReader(conn.getInputStream()));
String line;
StringBuffer buffer = new StringBuffer();
while ((line = rd.readLine()) != null)
{
buffer.append(line).append("\n");
}
System.out.println(buffer.toString());
rd.close();
conn.disconnect();
}catch(Exception e)
{e
.printStackTrace();
}
}}

Note: Required javax.servlet.jar and jdom.jar to execute ( downloadable from
internet,add to
classpath ).
PHP #
‘–Use URLEncode for parameter msgtext

<?php
$url = "http://getway.uaedes.ae/sendurlcomma.aspx?user=profileid&pwd=xxxx&senderid=ABC&mobilen o=9911111111&msgtext=Hello&CountryCode=ALL&scheduledDate=mm/dd/year hh:min am "; $ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$curl_scraped_page = curl_exec($ch);
curl_close($ch);
echo $curl_scraped_page;
?>

Click Me