راهنمای ارسال پیامک با DotNetCore

کتابخانه ارسال پیامک NetCore با وب سرویس قاصدک

وب‌سرویس پیامک قاصدک، یک سرویس ارسال و دریافت پیام کوتاه از طریق REST API برای ارسال پیامک‌های وب‌سرویسی است.

تلاش قاصدک روی این سرویس بر ارائه‌ی خدمات با کیفیت، قابل اتکا و ساده به کاربرانش هست. در این قسمت راهنمای ساده برای ارسال و دریافت پیامک از طریق کتابخانه قاصدک برای NetCore. آماده کردیم.

نحوه نصب کتابخانه .NetCore

برای استفاده از این کتابخانه، باید .NetCore 2.x را نصب داشته باشید. کتابخانه ghasedak رو به سادگی از روی nuget نصب کنید :


 Install-Package Ghasedak.Core

نحوه نصب از طریق CLI :


  dotnet add package Ghasedak.Core

نحوه استفاده از کتابخانه نصب شده

بعد از این مرحله نیاز هست که یک Instance از Ghasedak بسازید و کلید API خود را به این متد پاس دهید. اگر کلید API ندارید، می توانید بعد از ثبت نام این کلید را دریافت کنید، البته برای کاربران تازه، مقداری اعتبار رایگان برای تست در نظر گرفته شده است :


  var sms = new Ghasedak.Core.Api("apikey");

و بعد از اون می توانید به سادگی پیام خود را به شماره مورد نظر ارسال کنید :


  await sms.SendSMS("message", "0912xxxxxxx");

در این مثال تنها نیاز دارید که مقادیر مورد نظر خود را تغییر دهید.

قاصدک در گیت هاب

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

Ghasedak.Core

ghasedak.core .NET Core Helper Library

Adding Ghasedak.Core libraries to your .NET Core project

The best and easiest way to add the Ghasedak.Core libraries to your .NET Core project is to use the NuGet package manager.

Package Manager


  Install-Package Ghasedak.Core

.Net CLI


 dotnet add package Ghasedak.Core

Usage

Simple Send

 

 try
  {
    var sms = new Ghasedak.Core.Api("apikey");
    var result = await sms.SendSMS("message", "0912xxxxxxx");
    foreach (var item in result.Items)
     {
       Console.WriteLine(item);
     }
  }
  catch (Ghasedak.Core.Exceptions.ApiException ex)
  {
    Console.WriteLine(ex.Message);
  }
  catch (Ghasedak.Core.Exceptions.ConnectionException ex)
  {
   Console.WriteLine(ex.Message);
  }

OTP Send

 
                                                        
        try
        {
            var otpsms = new Ghasedak.Core.Api("apikey");
            var res = otpsms.Verify(1, "your template name",
            new string[] { "0912XXXXXXX", "0912XXXXXXX" },
            "param1", "param2", "param3", "param4", "param5", "param6", "param7", "param8", "param9", "param10");
            foreach(var item in res.Items)
            {
             Console.WriteLine("messageids:" + item);
            }
        }
        catch (Ghasedak.Core.Exceptions.ApiException ex)
        {
          Console.WriteLine(ex.Message);
        }
        catch (Ghasedak.Core.Exceptions.ConnectionException ex)
        {
           Console.WriteLine(ex.Message);
        }

Bulk Send

 

 try
 {
    var bulksms = new Ghasedak.Core.Api("apikey");
    var res = bulksms.SendSMS("message", "linenumber", new string[] { "0912xxxxxxx","0937xxxxxxxx" });
    foreach(var item in res.Items)
    {
     Console.WriteLine("messageids:" + item);
    }
 }
 catch (Ghasedak.Core.Exceptions.ApiException ex)
 {
   Console.WriteLine(ex.Message);
 }
 catch (Ghasedak.Core.Exceptions.ConnectionException ex)
 { 
  Console.WriteLine(ex.Message);
 }

Done!

.Net Core دانلود نمونه کد