برای ارسال یک پیامک به یک یا چند نفر و همچنین برای ارسال نظیر به نظیر پیامک میتوان از این متد استفاده نمود . با توجه به آرایه ای بودن پارامتر های ورودی این متد شما میتوانید ارسال های متفاوتی را انجام دهید . دو پارامتر آرایه ای این متد عبارتند از شماره های گیرنده و متون ارسالی که بر اساس تعداد آیتم های موجود در این دو آرایه شما میتوانید ارسال تکی ، ارسال انبوه و همچنین ارسال نظیر به نظیر داشته باشید.

توجه: برای ارسال به چند شماره و یا استفاده از چند متن، آنها را با کاما(,) از یکدیگر جدا نمایید.

آدرس: http://ws.nh1.ir/Api/SMS/Send

مثال برای نحوه صدا زدن سرویس: http://ws.nh1.ir/Api/SMS/Send?Username=a&Password=b&Text=c&To=d&From=e

پارامترهای ورودی ارسال

a(Username) : نام کاربری شما برای استفاده از سرویس (نوع:string)
b(Password) : کلمه عبور برای استفاده از سرویس(نوع:string)
e(From) : شماره ارسال پیامک(نوع:string)
d(To) : شماره های گیرندگان پیام(نوع:string)
c(Text) : متون ارسالی پیامک(نوع:string)

برای ارسال یک پیامک به یک یا چند نفر و همچنین برای ارسال نظیر به نظیر پیامک میتوان از این متد استفاده نمود . با توجه به آرایه ای بودن پارامتر های ورودی این متد شما میتوانید ارسال های متفاوتی را انجام دهید . دو پارامتر آرایه ای این متد عبارتند از شماره های گیرنده و متون ارسالی که بر اساس تعداد آیتم های موجود در این دو آرایه شما میتوانید ارسال تکی ، ارسال انبوه و همچنین ارسال نظیر به نظیر داشته باشید.

توجه: برای ارسال به چند شماره و یا استفاده از چند متن، آنها را با کاما(,) از یکدیگر جدا نمایید.

آدرس: http://ws.nh1.ir/Api/SMS/Receive

مثال برای نحوه صدا زدن سرویس: http://ws.nh1.ir/Api/SMS/Receive?Username=a&Password=b&LastIncommingId=c&LastIncommingDate=d

پارامترهای ورودی دریافت

a(Username) : نام کاربری شما برای استفاده از سرویس (نوع:string)
b(Password) : کلمه عبور برای استفاده از سرویس(نوع:string)
c(LastIncommingId) : کد آخرین پیامکی که گزارش آن را دریافت کرده ایم(نوع:int  اختیاری)
d(LastIncommingDate) : تاریخ آخرین پیامکی که گزارش آن را دریافت کرده ایم(نوع:date  اختیاری)

خروجی دریافت

• Id : کد پیامک در سیستم
• Text : متن پیامک
• From : شماره ایی که پیامک با آن ارسال شده است
• To : شماره گیرنده پیام
• RecieveDate : تاریخ و زمان دریافت پیامک

برای اطلاع از میزان شارژ خود می توانید از این سرویس استفاده نمایید.

آدرس: http://ws.nh1.ir/Api/SMS/Balance

مثال برای نحوه صدا زدن سرویس: http://ws.nh1.ir/Api/SMS/Balance?Username=a&Password=b

پارامترهای ورودی میزان شارژ

a(Username) : نام کاربری شما برای استفاده از سرویس (نوع:string)
b(Password) : کلمه عبور برای استفاده از سرویس(نوع:string)

خروجی میزان شارژ

• مبلغ شارژ

برای دریافت گزارش پیامک های ارسالی کافیست SMSId آخرین پیامی که گزارش آن را دریافت نموده اید(بزرگترین SMSId) را به عنوان پارامتر داده و 50 پیام بعد از آن را دریافت نمایید.

آدرس: http://ws.nh1.ir/Api/SMS/ReportBulkSMS

مثال برای نحوه صدا زدن سرویس: http://ws.nh1.ir/Api/SMS/ReportBulkSMS?Username=a&Password=b&SMSId=c

پارامترهای ورودی گزارش

a(Username) : نام کاربری شما برای استفاده از سرویس (نوع:string)
b(Password) : کلمه عبور برای استفاده از سرویس(نوع:string)
c(SMSId) : Id آخرین پیام گزارش شده(بزرگترین SMSId):(نوع:int)

خروجی گزارش

• SMSId : کد پیامک در سیستم
• Recipient : گیرنده پیامک
• Sender : شماره ایی که پیامک با آن ارسال شده است
• Status : وضعیت پیامک
• Parts : تعداد بخشهای پیامک
• Text : متن پیامک
• SentTime : تاریخ و زمان ارسال پیامک

•         1 = Ok
•             2 = نام کاربری و یا رمز عبور اشتباه می باشد.
•           11 = خطای شارژ ناکافی(شارژ زیر 50،000 ريال)
•   10001 = نام کاربری و رمز عبور را وارد نکرده اید.
•   10002 = نام کاربری را وارد نکرده اید.
•   10003 = رمز عبور را وارد نکرده اید.
•   10004 = شماره ارسال را وارد نکرده اید.
•   10005 = شماره ارسال نامعتبر می باشد.
•   10006 = شما مجوز دسترسی به این سرویس را ندارید.
•   10007 = یکی از پارامترها را وارد نکرده اید.
•   10008 = یکی از پارامترها را با فرمت نامناسب وارد کرده اید.
•   10009 = تعداد شماره ها و یا پیامک ها برای ارسال بیش از حد مجاز(500 پیامک) می باشد.
• 100010 = اعتبار شما برای ارسال کافی نمی باشد.
• 100011 = شماره موبایل وارد شده نامعتبر می باشد.
• 100012 = تعداد متون ارسالی درست نمی باشد.(یک پیامک به یک یا چند نفر و یا ارسال نظیر به نظیر پیامک)
• 100151 = اکنون زمان مناسبی برای گزارش گیری نمی باشد.

string SendSMS()
{
    string URL = "http://ws.nh1.ir/Api/SMS/Send";
    string Username = "Your Username";
    string Password = "Your Password";
    string Text = "Text";
    string Recipient = "+98**********";
    string Channel = "***********";
    string parameters = string.Format("UserName={0}&Password={1}&Text={2}&To={3}&From={4}", Username, Password, Text, Recipient, Channel);

    try
    {
        URL = string.Concat(URL.ToString(), "?", parameters.ToString());
        var request = System.Net.WebRequest.Create(URL);
        request.Method = "GET";
        using (var response = request.GetResponse())
        {
            using (var stream = response.GetResponseStream())
            {
                var sr = new System.IO.StreamReader(stream);
                string result = sr.ReadToEnd();
                sr.Close();
                return result;
            }
        }
    }
    catch (System.Exception ex)
    {
        return ex.Message;
    }
}
    

string ReceiveSMS()
{
    string URL = "http://ws.nh1.ir/Api/SMS/Receive";
    string Username = "Your Username";
    string Password = "Your Password";
    string LastIncommingId = "1";
    string LastIncommingDate = "2013/01/15";
    string parameters = string.Format("UserName={0}&Password={1}&LastIncommingId={2}&LastIncommingDate={3}", Username, Password, LastIncommingId, LastIncommingDate);

    try
    {
        URL = string.Concat(URL.ToString(), "?", parameters.ToString());
        var request = System.Net.WebRequest.Create(URL);
        request.Method = "GET";
        using (var response = request.GetResponse())
        {
            using (var stream = response.GetResponseStream())
            {
                var sr = new System.IO.StreamReader(stream);
                string result = sr.ReadToEnd();
                sr.Close();
                return result;
            }
        }
    }
    catch (System.Exception ex)
    {
        return ex.Message;
    }
}
    

string GetBalance()
{
    string URL = "http://ws.nh1.ir/Api/SMS/Balance";
    string Username = "Your Username";
    string Password = "Your Password";
    string parameters = string.Format("UserName={0}&Password={1}", Username, Password);

    try
    {
        URL = string.Concat(URL.ToString(), "?", parameters.ToString());
        var request = System.Net.WebRequest.Create(URL);
        request.Method = "GET";
        using (var response = request.GetResponse())
        {
            using (var stream = response.GetResponseStream())
            {
                var sr = new System.IO.StreamReader(stream);
                string result = sr.ReadToEnd();
                sr.Close();
                return result;
            }
        }
    }
    catch (System.Exception ex)
    {
        return ex.Message;
    }
}
    

string ReportBulkSMS()
{
    string URL = "http://ws.nh1.ir/Api/SMS/ReportBulkSMS";
    string Username = "Your Username";
    string Password = "Your Password";
    int SMSId = [SMSId];
    string parameters = string.Format("UserName={0}&Password={1}&SMSId={2}", Username, Password, SMSId);

    try
    {
        URL = string.Concat(URL.ToString(), "?", parameters.ToString());
        var request = System.Net.WebRequest.Create(URL);
        request.Method = "GET";
        using (var response = request.GetResponse())
        {
            using (var stream = response.GetResponseStream())
            {
                var sr = new System.IO.StreamReader(stream);
                string result = sr.ReadToEnd();
                sr.Close();
                return result;
            }
        }
    }
    catch (System.Exception ex)
    {
        return ex.Message;
    }
}