ارسال پیامک از طریق api key

ارسال پیامک از طریق api key

Engagements Icon
80

کلید api یکی از ابزارهای استفاده از وب سرویس می‌باشد. در این مقاله سعی داریم تا ارسال پیامک از طریق کلید api را شرح دهیم.

Application Programming Interface که به اختصار  API نامیده می‌شود، یک رابط برنامه نویسی است که با استفاده از آن پیچیدگی پیاده‌سازی بخش‌هایی از پروژه‌ی شما حذف خواهد شد.

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

وب‌سایتت رو به پیامک مجهز کن!

با ارسال پیامک در هنگام ثبت‌نام مشتری را احراز هویت کنید و خیال مشتری را پس از خرید با یک پیامک راحت کنید!
10% تخفیف!
API10
کپی کد
برای ارسال پیامک تکی و انبوه همین الان ثبت نام کنید
ثبت نام و ارسال پیامک آنی

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

API چیست؟

قبل از اینکه به سراغ کلید api برویم، باید بدانیم که API دقیقا چیست؟ با ذکر یک مثال api را توضیح خواهم داد تا درک این مورد برای شما میسر گردد.

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

مثال پیشخدمت برای api

شما قصد میل کردن یک غذای دلخواه را دارید، بجای اینکه خودتان دست‌به‌کار شوید و صفر تا صد آن وعده را آماده کنید، تنها با پرداخت هزینه و چند درخواست ساده در کمترین زمان غذای دلخواه شما برایتان آماده خواهد شد. در این مثال آشپزخانه را یک سرور (یا ارائه دهنده یک سرویس خاص) در نظر بگیرید.

شما که در حال سفارش غذا هستید بعنوان کلاینت (یا درخواست کننده آن سرویس) می‌باشید و پیشخدمت رستوران نیز api می‌باشد که زحمت را شما را کم کرده، درخواست شما را دریافت کرده و به سرویس دهنده موردنظر ارجاع می‌دهد، و نتیجه درخواست یا سفارش شما را به شما تحویل می‌دهد.

Web API یا وب سرویس چیست؟

حال که با واژه‌ی api آشنا شدیم، به سراغ وب سرویس یا web api می‌رویم.

تفاوت web api و api در این است، که web api برای اجرا نیاز به شبکه جهانی یا اینترنت دارد.

web api  را به این شکل در نظر بگیرید:

شما می‌خواهید امکان یا ویژگی‌ای به پروژه برنامه‌نویسی خود اضافه کنید (بعنوان مثال ارسال پیامک کد تأیید یا استفاده از نقشه گوگل) وقتی ویژگی مورد نیاز شما از قبل در یک وب سرویس پیاده‌سازی شده و در کنار آن web api نیز ارائه شود،

دیگر نیاز نیست که شما صفر تا صد آن سرویس خاص را خودتان پیاده سازی کنید، به راحتی با استفاده از api ایجاد شده توسط شرکت ارائه دهنده سرویس، می‌توانید به هدف خود برسید.

کلید api چیست؟

کلید api یا همان api token یک رشته‌ای از کاراکتر است که در فراخوانی سرویس به همراه مابقی پارامترهای مورد نیاز از سمت کاربر (یا کلاینت) به وب سرویس ارسال می‌شود. اما کلید api که به صورت عمومی در سامانه‌های پیامکی معرفی می‌شود، دقیقا در تعریف api key قرار نمی‌گیرد. آنچه در اصل بعنوان کلید api در سرویس‌های پیامکی مورد استفاده قرار می‌گیرد، کلید احراز هویت می‌باشد.

ارسال پیامک کد لایسنس با افزونه اسپات پلیر در وردپرسحتما بخوانید: ارسال پیامک کد لایسنس با افزونه اسپات پلیر در وردپرس

این کلید در اصل برای شناسایی و احراز هویت کاربرانی که در حال استفاده از web api می‌باشند به کار برده می‌شود. اما کلید api برای شناسایی و احراز هویت پروژه‌هایی (اپلیکیشن‌ها، نرم افزارها و ...) که از وب سرویس استفاده می‌کنند به کار گرفته می‌شود. بعنوان مثال با استفاده از کلید api می‌توان دسترسی تلفن‌های همراه که دارای سیستم عامل اندروید باشند، به وب سرویس را ممنوع کرد.

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

تا به اینجای کار، ما تفاوت کلید api و کلید احراز هویت را عنوان کردیم و مشخص شد آنچه که به عنوان کلید api مورد استفاده قرار می‌گیرد در واقع همان کلید احراز هویت می‌باشد. اما از آنجایی که واژه‌ی کلید api بصورت عمومی برای کلید احراز هویت استفاده می‌شود، ما نیز در این مقاله از همین واژه استفاده می‌کنیم.

استفاده از کلید api در وب سرویس ملی پیامک

احراز هویت برای استفاده از وب سرویس در سامانه ملی پیامک به دو صورت انجام می‌شود.

  • نام کاربری و رمز عبور: هنگامی که شما در سامانه ملی پیامک ثبت‌نام خود می‌کنید، به شما یک نام کاربری و رمز عبور تعلق می‌گیرد که با استفاده از آن می‌توانید وارد پنل کاربری پیامکی شده و همچنین در وب سرویس از آن استفاده کنید. برای مشاهده مستندات اینجا کلیک کنید.
  • استفاده از کلید api (کنسول ملی پیامک: در کنسول ملی پیامک می‌توان با استفاده از کلید api ایجاد شده برای هر حساب کاربری در سامانه ملی پیامک، از web api استفاده نمود.

کنسول ملی پیامک

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

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

در این سرویس شما دیگر نیازی به استفاده از نام کاربری و رمز عبور خود ندارید و ارسال درخواست‌ها و همچنین احراز هویت کاربران با استفاده از کلید api صورت می‌گیرد.

صفحه ورود کنسول ملی پیامکاین سرویس به صورت کامل بر پایه‌ی معماری RESTful پیاده سازی شده و از سرعت بالایی برخوردار است. همچنین برای استفاده‌ی هرچه راحت‌تر نمونه کدهای از پیش آماده شده برای زبان‌های برنامه‌نویسی php ، جاوا (اندروید) و c# (.netcore) قرار داده شده است. تا تنها با کپی کردن آن در پروژه خود بتوانید از ارسال پیامک از طریق کلید api استفاده کنید. هنگامی که در کنسول ثبت نام خود را تکمیل کردید، در بخش تنظیمات می‌توانید کلید api خود را مشاهده نمایید. این کلید با نام کاربری و رمز عبور پنل کاربری شما در سامانه ملی پیامک ارتباط مستقیم داشته و در صورت تغییر آن، کلید api شما نیز در کنسول فاقد اعتبار خواهد بود. کلید api در کنسول ملی پیامک

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

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

جمع‌بندی

برای ارسال پیامک از طریق کلید api، سامانه ملی پیامک سرویس کنسول را پیشنهاد می‌دهد، این سرویس بر پایه‌ی معماری REST بوده و در کمترین زمان ممکن پیاده‌سازی api در پروژه‌ی شما را ممکن می‌سازد.

کنسول ملی پیامک با دارا بودن api token هم امنیت ارتباط با وب سرویس را تضمین می‌کند و هم پیچیدگی ارسال درخواست به وب سرویس را کاهش می‌دهد.

به دنبال رشد کسب و کارتان هستید؟ ملی‌پیامک به شما امکان جذب، نگهداری و تعامل با مشتری را می دهد.
ثبت نام و ارسال پیامک ثبت نام در کمتر از 1 دقیقه
در بحث‌‌ پیرامون این مقاله شرکت کنید! ارسال دیدگاه

تیم تحریریه ملی پیامک

هر آنچه در ملی پیامک می خوانید، حاصل یک کوشش تیمی است؛ کوششی در جهت یافتن درست‌ترین پاسخ به مسائل و انتقال آن به شما. ما امیدواریم تلاش‌های مجموعه ما بتواند تاثیری هر چند کوچک در بهبود کیفیت فضای دیجیتال ایران داشته باشد.
درباره تیم ما بیشتر بدانید
53دیدگاه
در بحث‌‌ پیرامون این مقاله شرکت کنید!
ارسال دیدگاه

  • Gravatar Icon

    رستم نژاد

    3 سال پیش

    سلام ممنون از مقاله های خوبتون بسیار کامل و جامع هستند کاملا مشخص هست تیم محتوا نویس اشراف زیادی به مباحث فنی دارند خدا قوت بهتون

  • Gravatar Icon

    عباسی

    3 سال پیش

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

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

      سلام دوست عزیز.
      شما با تهیه تنها یک پنل (پنل اقتصادی یا بالاتر) می‌توانید هم برای استفاده از وبسرویس و هم ارسال پیامک‌های تبلیغاتی اقدام فرمایید.
      در صورت نیاز به مشاوره بیشتر می‌توانید با شماره تماس 02163404 تماس حاصل فرمایید

  • Gravatar Icon

    امیرمحمد بزمانی

    3 سال پیش

    وبسرویس‌تون که رفته روی api key خیلی بهتر شده دیگه نیاز نیست تیو برنامه نویسی همه چی رو بهش معرفی کنی
    ممنونم که به فکر هستید

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

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

  • Gravatar Icon

    بوکا

    3 سال پیش

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

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

      ممنون از شما.

  • Gravatar Icon

    محسن نخعی

    3 سال پیش

    سلام وقت بخیر
    با این کنسول میشه به همه شماره ها پیامک ارسال کرد؟
    یا ارسال شماره محدود هستش و به یه سری از افراد خاص باید ارسال کرد و میشه منطقه بندی کرد ارسال پیامک ها رو ؟؟
    یه جوری شخصی سازی ایجاد بشه؟
    مرسی از راهنمایتون

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

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

  • Gravatar Icon

    علیرضا آقا پور

    3 سال پیش

    بنده خودم برنامه نویس نیستم و یکی دیگه داره کار های سایت رو انجام میده به ما گفته که از ملی پیامک پنل تهیه کنیم و دسترسی کنسول رو براش بفرستیم برای تهیه کنسول باید از کدوم قسمت اقدام به خرید کنیم؟

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

      برای استفاه از کنسول ملی پیامک و یا وبسرویس قدیمی سامانه ملی پیامک، تهیه پنل مشابه می‌باشد و از بخش ثبت نام در هدر سایت می‌توانید به تهیه پنل اقدام فرمایید.
      اما در نظر داشته باشید که پنل پایه در سامانه ملی پیامک دارای امکان api نمیباشد.

  • Gravatar Icon

    صراف سرخ

    3 سال پیش

    برای باشگاه مشتریان هم میشه از وب سرویس پیامکی شما به جهت ارسال انبوه به مشتریانمون استفاده کنیم؟
    سپاس از راهنمایی

    • Gravatar Icon

      سینا جعفری

      3 سال پیش

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

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام و درود بر شما
    برای این مورد لطفاً با همکاران واحد فروش ملی پیامک 02163404 تماس بگیرید.
    پیشنهاد می‌کنم صفحه مقررات و قوانین ملی پیامک (https://www.melipayamak.com/rules/) رو هم مطالعه بفرمایین!

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    برای ارسال پیامک تبلیغاتی و آموزش دقیق انجام آن (چه از پنل کاربری پیامکی و یا چه از طریق api) می‌توانید با واحد پشتیبانی سامانه ملی پیامک 02163404 تماس حاصل فرمایید تا راهنمایی لازم ارائه شود.

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام دوست عزیز
    پنل اقتصادی قابلیت استفاده از کنسول را دارا میباشد و نیازی به ارتقا پنل ندارید

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام خدمت شما دوست گرامی
    برای استفاده از کنسول ملی پیامک می‌توانید از پنل اقتصادی یا بالاتر استفاده نمایید.
    در پنل پایه امکان استفاده از کنسول موجود نمیباشد.
    برای راهنمایی در مورد تهیه پنل پیامکی مورد نظر خود می‌توانید با پشتیبانی ملی پیامک (021-63404) تمای حاصل فرمایید

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام
    احتراما از لینک زیر وارد صفحه کنسول شوید:
    https://console.melipayamak.com/auth/login
    همچنین ویدیو آموزشی و راهنمای کنسول ملی پیامک نیز در این مقاله قرار داده شده است

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

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

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

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

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام.
    سرویس کنسول در همه‌ی پنل های ارائه شده در سامانه ملی پیامک به جز پنل پایه قابل استفاده می‌باشد

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام.
    بله. در کنسول ملی پیامک متد “ارسال از خط خدماتی” برای ارسال پیامک به لیست سیاه مخابرات (یا همان سرویس ارسال پیامک از طریق پترن می‌باشد)

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام
    سرویس کنسول ملی پیامک برای نرم افزار هلو قابل استفاده نمی‌باشد.
    پیاده سازی انجام شده در نرم افزار هلو برای سرویس معمولی ملی پیامک میباشد که از نام کاربری و رمز عبور استفاده می‌کند

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام، وقت بخیر دوست عزیز
    ویدیو آموزشی کنسول ملی پیامک در همین مقاله بارگذاری شده و بصورت کامل توضیحات را ارائه می‌دهد.
    برای دسترسی به کنسول ملی پیامک می‌توانید از لینک زیر استفاده کنید.
    https://console.melipayamak.com/auth/login

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

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

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام
    کنسول ملی محدودیتی در زمینه استفاده ندارد. در تمامی فریمورکها و زبان‌های برنامه نویسی که قابلیت استفاده از api را داشته باشند می‌توان از کنسول استفاده نمود.

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    با سلام
    برای استفاده از وبسرویس در افزونه‌ها باید در نظر داشته باشید که توسعه دهنده افزونه از یکی از روش‌های موجود در api سامانه ملی پیامک استفاده نموده است.
    بصورت پیشفرض از api سامانه ملی پیامک در افزونه‌های قدیمی استفاده نمی‌گردد و باید از نام کاربری و رمز عبور در افزونه خود استفاده نمایید.
    زیرا api key ارائه شده در کنسول ملی پیامک به تنهایی قابل استفاده بوده و دیگر نیازی به استفاده از رمز عبور نخواهد بود. اگر افزونه شما تنها و تنها نیاز به api key داشته و نیازی به رمز عبور ندارد میتوانید از سرویس کنسول استفاده نمایید

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام.
    بله. دیگر نیازی به استفاده از کدها و package های گیت هاب وجود ندارد و می‎توانید از کدهای آماده موجود در کنسول ملی پیامک استفاده فرمایید

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام دوست گرامی
    برای استفاده از کنسول می‌توانید پنل اقتصادی یا پنل‌های بالاتر را تهیه فرمایید که قابلیت استفاده از api را دارند.
    در کنسول ملی پیامک استفاده از خط خدماتی اشتراکی (یا همان سرویس ارسال پیامک از طریق پترن ) :https://www.melipayamak.com/blog/posts/sms-with-pattern-mode/ قرار داده شده است.
    در صورتیکه دارای خط خدماتی اختصاصی بر روی پنل کاربری خود هستید نیز امکان استفاده از آن نیز وجود دارد.

  • Gravatar Icon

    سینا جعفری

    3 سال پیش

    سلام دوست عزیز
    وقت شما هم بخیر باشه، برای تمدید پنل، کافیه که 60درصد هزینه اولیه پنل‌تون رو از قسمت {شارژ حساب} در داخل سامانه پرداخت بفرمایید و بعدش از طریق تماس با پشتیبانی 02163404 یا ارسال تیکت، درخواست تمدید پنل رو داشته باشید.
    البته که پیشنهاد می‌کنم اگه فراموش کردین که پنل شما کدومه، حتماً با پشتیبانان ملی پیامک 02163404 در ارتباط باشید تا به صورت دقیق راهنمایی‌تون کنند.

12

ارسال پیامک از اینترنت

ارسال و دریافت پیامک تکی و انبوه با شماره های اینترنتی
مشاهده تعرفه ها فعالسازی در کمتر از 1 دقیقه

ثبت نام

در کمتر از 1 دقیقه ارسال پیامک را شروع کنید.

شرایط و قوانین را مطالعه کرده و قبول دارم.

پنل خود را انتخاب کنید