آموزش استفاده از وب سرویس پیامک

امروزه در اکثر برنامه های تحت وب، سایت ها و اپلیکیشن های موبایل، از پیامک استفاده می شود. تقریبا اکثر برنامه ها در بسیاری از موارد از ویژگی های پیامک، مانند تایید شماره تلفن، تنظیم مجدد رمز عبور و احراز هویت و… استفاده می کنند.

امکان پیشرفته API تحت وب یا همان WebService ، برای برنامه نویسان و طراحان وب سایت کاربرد بسیاری دارد و آنها را قادر می سازد تا با استفاده از سرویس های تحت وب، بتوانند پیامک های خود را با استفاده از خطوط لیمو اس ام اس به آسانی ارسال و دریافت نمایند.

از مهمترین کاربردهای پنل پیامک رایگان لیمو اس ام اس ، قابلیت اتصال آن به نرم افزار های خارجی و سایت ها است ، این کاربرد باعث می شود، تا نرم افزار های کاربردی دیگر قادر باشند در شرایط مختلف پیامک ارسال نمایند. در مورد بسیاری از وب سایت ها و نرم افزار ها این امکان بسیار حیاتی می باشد.

مستنداتی که در ادامه شرح داده می شود براي استفاده آن دسته از برنامه نویسانی طراحی شده است که می خواهند از سرویس  RestFulلیمو اس ام اس استفاده نمایند. در این راهنما روش ها و دستورات مورد نیاز برنامه نویسان در هنگام استفاده از سرویس RestFul شرح داده شده است. سرویس RestFul به دلیل سادگی پیاده سازي و حمایت از تمامی زبانهاي برنامه نویسی از جمله محبوب ترین روش هاي مورد استفاده جهت ارسال پیام از طریق نرم افزار می باشد

در ادامه به بررسی نحوه ی ارسال پیامک در C# از طریق سامانه پنل اس ام اس رایگان لیمو اس ام اس می پردازیم:

در منوی سمت راست در قسمت «ویژه برنامه نویسان»، زیرمنوی «دریافت کد دسترسی» را انتخاب کنید.

برای شروع کار با وب سرویس ابتدا نیاز است که در سامانه احراز هویت را انجام دهید. برای این کار لازم است ابتدا مدارک خود را ارسال و منتظر تایید مدارک از طرف کارشناسان باشید که در صورت موفقیت آمیز بودن و تایید مدارک ، کد دسترسی به شما نمایش داده خواهد شد. شما با استفاده از کد دسترسی می توانید از وب سرویس ها استفاده نمایید .

سامانه پیامکی رایگان لیمو اس ام اس می تواند با استفاده از ارسال پیامک تبلیغاتی امکانات ویژه خود شما را در این کار همکاری نماید ، مشاوران ما در کنار شما خواهند بود

·         متد ارسال پیامک تکی و گروهی (C#)

این وب سرویس برای ارسال پیام به یک یا چند شخص و به صورت زمانبندی استفاده می شود .

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

و به عنوان پارامتر خروجی نتیجه و توضیحات ارسال پیام به همراه شناسه پیام ها برای دریافت وضعیت ارسال را به شما برمیگرداند.

برای ارسال پیامک بصورت تکی و گروهی از نمونه کدهای زیر می توانید استفاده کنید.

var client = new HttpClient();
string[] receiver = { “شماره موبایل“};
var data = new
{
Message = “متن پیام“,
SenderNumber = “شماره ی فرستنده“,
MobileNumber = receiver,
SendToBlocksNumber = true
};
var url = “https://api.limosms.com/api/sendsms”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

·         متد ارسال پیام متناظر

این وب سرویس برای ارسال پیام متناظر به صورت زمانبندی استفاده می شود.

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

و به عنوان پارامتر خروجی نتیجه و توضیحات ارسال پیام به همراه شناسه پیام ها برای دریافت وضعیت ارسال را به شما برمیگرداند.

 برای اجرای این وب سرویس می توانید از کد زیر استفاده کنید.

var client = new HttpClient();
string[] receiver = { “گیرنده ی دوم” , “گیرنده ی اول“};
string[] Message = { “پیام دوم” , “پیام اول“};
var data = new
{
Message = Message,
SenderNumber = “فرستنده“,
MobileNumber = receiver,
SendToBlocksNumber=true,
};
var url = “https://api.limosms.com/api/sendpeertopeersms”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

·         متد ارسال پترن (الگو)

در ارسال پیامک وب سرویس از طریق پترن شما متن کلی پیامک را مشخص می‌کنید و فقط در بعضی از موارد که نیاز است متغیر قرار می‌دهید، بنابراین کلیت متن شما ثابت است و یک مرتبه واحد فیلترینگ متن پیامک را تایید می‌کند در صورتی که متن پیامک تبلیغاتی نباشد یک کد الگو در اختیار شما قرار می‌گیرد زمانی که شما از طریق این الگو پیامک ارسال می‌کنید بدون تایید ناظر انسانی پیامک ارسال می‌شود و پیامک ارسال شده در کمتر از 5 ثانیه به دست مخاطب می‌رسد.

ابتدا وارد قسمت « تنظیمات پترن(الگو)» شوید . و سپس بر روی افزودن الگوی جدید کلیک کنید تا پنجره افزودن الگو به شما نمایش داده شود.

متن مورد نظر خود را بنویسید و هر قسمتی که نیاز به متغیر دارید بر روی افزودن توکن کلیک کنید. مثلا در مثال فوق {0} توکنی است که نام کاربری کاربر در آن متغیر قرار میگیرد.

پس از ذخیره پترن، شما باید منتظر باشید تا پترن شما توسط واحد فیلترینگ لیمو اس ام اس تایید شود و پس از آن می توانید از وب سرویس زیر برای ارسال پیامک استفاده کنید.

var client = new HttpClient();
string[] Message = { “تست” };
var data = new
{
OtpId = “1”,
ReplaceToken = Message,
MobileNumber = “گیرنده“,
};
var url = “https://api.limosms.com/api/sendpatternmessage”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

این متد شناسه متن پیام، متنهای جایگزین توکن و شماره های دریافت کننده را به عنوان پارامتر ورودی دریافت می کند و به عنوان پارامتر خروجی نتیجه و توضیحات ارسال پیام را به شما برمیگرداند.

 برای ثبت سفارش ارسال پیامک انبوه  بصورت رایگان در سامانه پیامکی لیمو اس ام اس ثبت نام کنید.

·         متد احراز هویت

در ارسال پیامک احراز هویت از طریق API شما باید شماره موبایل را وارد کنید تا کد برای شماره مربوطه ارسال گردد . همچنین می توانید فوتری هم برای پیام ارسال کد مشخص و ارسال کنید. به عنوان مثال آدرس سایتتان.

این متد شماره موبایل دریافت کننده کد و متن فوتر را به عنوان پارامتر ورودی دریافت می کند و به عنوان پارامتر خروجی نتیجه و توضیحات ارسال پیام را به شما برمیگرداند.

var client = new HttpClient();
var data = new
{
Mobile = “گیرنده“,
Footer = “خوش امدید“,
};
var url = “https://api.limosms.com/api/sendcode”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

·         متد دریافت وضعیت احراز هویت

برای چک کردن احراز هویت شماره موبایل کاربر از طریق api شما باید شماره موبایل و کد وارد شده توسط کاربر خود را ارسال کنید تا بررسی ها انجام و نتیجه به شما نمایش داده شود.

این متد شماره موبایل دریافت کننده کد و کد وارد شده توسط کاربر را به عنوان پارامتر ورودی دریافت می کند و به عنوان پارامتر خروجی نتیجه احراز هویت و توضیحات را به شما برمیگرداند.

var client = new HttpClient();
var data = new
{
Mobile = “گیرنده“,
Code = “123655”,
};
var url = “https://api.limosms.com/api/checkcode”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

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

این وب سرویس برای دریافت پیام های دریافتی ارسال شده به خط اختصاصی شما استفاده می شود. توجه : در هر درخواست حداکثر 100 تا پیام برگشت داده می شود.

این متد، شماره اختصاصی شما، شماره صفحه و تعداد پیام را به عنوان ورودی دریافت می کند و نتیجه ی ارسال پیام، توضیحات پیام و لیست پیام ها را به عنوان خروجی بر میگرداند.

برای استفاده از متد دریافت پیام های دریافتی می توانید از قطعه کد زیر استفاده کنید.

var client = new HttpClient();
var data = new
{
Number = “شماره ی اختصاصی شما“,
Page = شماره ی صفحه,
Size = تعداد
};
var url = “https://api.limosms.com/api/getreceivedmessage”;
client.DefaultRequestHeaders.Add(“ApiKey”, “کد دسترسی شما“);
var objectStr = JsonConvert.SerializeObject(data);
var content = new StringContent(objectStr, Encoding.UTF8, “application/json”);
var response = client.PostAsync(url, content).Result;
string resultContent = await response.Content.ReadAsStringAsync();
return resultContent;

سخن پایانی

SMS (سرویس پیام کوتاه) اکنون در سراسر جهان از طریق دستگاه های تلفن همراه به عنوان رسانه ارتباط فوری استفاده می شود. در این مقاله مراحل ارسال پیامک با استفاده از کد سی شارپ توضیح داده شده است. شما می توانید از طریق این کد در  ASP.Net با استفاده از کد سی شارپ پیامک ارسال کنید. تمام قابلیت ها در قسمت «مستندات API» در قسمت «برنامه نویسان» پنل لیمو اس ام اس موجود می باشد.

ثبت نام رایگان در پنل پیامک 🍋 لیمو اس ام اس 🍋

مقالات پیشنهادی:

✅ ارسال پیامک از روی نقشه [قابلیت جدید]

✅ تفاوت خطوط اشتراکی، اختصاصی و خدماتی