یکی از امکاناتی که هر وب سایت بزرگی از آن استفاده می کند، وب سرویس پیامک است. وب سایت ها و برنامه ها از وب سرویس پیام کوتاه برای ارسال پیامک اعلان برای ثبت نام و ورود کاربر، OTP و رمز فراموش شده، ثبت سفارش و تغییر وضعیت سفارش، پر کردن فرم، ارسال و غیره استفاده می کنند. بنابراین برنامه نویسان یا توسعه دهندگان این شرکت ها ممکن است در هنگام پیاده سازی و استفاده از وب سرویس و API SMS با خطاهایی مواجه شوند. در این مقاله لیستی از خطاهای وب سرویس پیامک را در اختیار شما قرار می دهیم، اما قبل از بررسی لیست خطاهای وب سرویس پیامک، باید بدانیم وب سرویس چیست؟
وب سرویس و API چیست؟
وب سرویس (وب سرویس) یا API به معنی واسط برنامه نویسی اپلیکیشن یکی از اصطلاحات رایج در بین برنامه نویسان است و در واقع یک رابط برنامه نویسی است که بر روی بستر وب پیاده سازی می شود و این رابط ها از پروتکل های استاندارد مانند http و https، توابع و مکانیزم ها استفاده می کنند. و عملکردهای مختلفی را در اختیار برنامه نویسان قرار می دهند. یک وب سرویس مانند یک پل ارتباطی است که توسط سازمان W3C برای تبادل اطلاعات بین نرم افزارها و سایت های مختلف ایجاد شده است. وب سرویس SMS مانند یک پل ارتباطی است که برای ارسال پیامک اطلاعاتی در مورد سایت، برنامه، نرم افزار یا CRM شما به مدیران و مشتریان شما استفاده می شود.
خواندن مقاله ” وب سرویس و API چیست؟ این به شما کمک می کند تا وب سرویس را بهتر درک کنید.
شما یا برنامه نویس و توسعه دهنده وب سایت یا نرم افزار خود با استفاده از وب سرویس می توانید از انواع خدمات وب ملی پیامک استفاده کنید. ملی پیامک یکی از قدرتمندترین و جامع ترین سامانه های پیامک است که به شما امکان مدیریت پیامک های ارسالی، پیامک های دریافتی، پیام های زمانی، دفترچه تلفن، پیام های صوتی و … را می دهد. با دانستن خطاهای وب سرویس پیام کوتاه، در صورت بروز مشکل می توانید به راحتی مشکل را حل کنید.
انواع وب سرویس های پیامکی
قبل از وارد کردن خطا در وب سرویس پیامک، بهتر است با انواع وب سرویس ها و API های سامانه ملی پیامک آشنا شوید. به طور کلی روش ها و عملکردهای وب سرویس ملی پیامک به 8 دسته کلی زیر تقسیم می شوند:
- وب سرویس برای ارسال پیامک
- یک وب سرویس برای ارسال پیام های متنی با استفاده از الگوها و الگوها
- وب سرویس برای دریافت پیامک
- سرویس پست صوتی وب
- وب سرویس برای ارسال برنامه ریزی شده پیامک
- سرویس دایرکتوری وب
- وب سرویس برای تحویل انبوه و منطقه ای
- وب سرویس نماینده
حال همانطور که کمی پیشتر اشاره کردیم ممکن است هنگام استفاده از وب سرویس پیامک با خطاهایی مواجه شوید. لیست کامل و جامعی از خطاهای وب سرویس پیامک را در این مقاله قرار داده ایم.
لیست خطاهای سرویس وب اس ام اس
از آنجایی که جمع آوری تمام خطاهای احتمالی وب سرویس پیامک از حوصله این مقاله خارج است و کلیه اطلاعات لازم در صفحه مستندات وب سرویس پیامک موجود است، در زیر و به اختصار فقط خطاهای وب سرویس پیامک (وب سرویس عادی و ما خطاهای زمانی را فهرست کرده ایم) ارسال از خط اختصاصی) و ارسال پیامک از طریق وب سرویس بر اساس مدل ها و قالب ها (وب سرویس برای سرویس). برای درک بهتر تفاوت پیامک خط اختصاصی و پیامک خط سرویس اشتراکی، توجه شما را به تعریف مختصری از هر یک جلب می کنم.
خط تخصصی: هر کدام از پنل های سامانه ملی پیامک دارای حداقل 1 خط مجازی فرستنده پیامک یا همان تعداد پیام کوتاه هستند که معمولاً به صورت تبلیغاتی فعال می شوند و امکان ارسال پیامک به افرادی که سیم کارت خود را مسدود کرده اند. پیامک تبلیغاتی (لیست سیاه مخابرات) ) ندارد
خط سرویس: این خطوط توسط اپراتورها با ارائه مدارک ویژه از حالت تبلیغاتی به حالت خدماتی تغییر یافته و امکان ارسال پیامک به مخاطبینی که در لیست سیاه مخابرات هستند را فراهم می کند. پیشنهاد می‌کنم برای اطلاعات بیشتر به صفحه «خط خدمات چیست؟» مراجعه کنید. نگاه کن
خطا در ارسال پیامک از طریق وب سرویس
بعد از اینکه از وب سرویس ملی پیامک استفاده کردید، در پاسخ به درخواست وب سرویس و API از سامانه ملی پیامک شماره ای را نشان می دهد، این شماره ها معانی مختلفی دارند.
رشته ای از اعداد چند رقمی: ارسال پیامک recId که یک مقدار منحصر به فرد برای هر ارسال موفق است. (اگر recId دریافت کردید که عددی با بیش از 15 رقم است، به این معنی است که ارسال با موفقیت انجام شده است و می توانید از روش دریافت گزارش مانند GetDeliveries برای دریافت گزارش و وضعیت ارسال استفاده کنید.)
1-: یک خطای نامشخص رخ داده است. با پشتیبانی تماس بگیرید.
0: پنل پیامک نمی تواند به وب سرویس متصل شود / نام کاربری یا رمز عبور وارد شده نادرست است.
1: پیامک با موفقیت ارسال شد.
2: موجودی و اعتبار پنل پیامک کافی نیست.
3: محدودیت ارسال روزانه
4: محدودیت حجم و تعداد پیامک های ارسالی
5: شماره فرستنده یا شماره پیامک معتبر نیست.
6: سیستم در حال به روز رسانی است.
7: متن پیامک حاوی یک کلمه یا کلمات فیلتر شده است.
8: به حداقل تعداد پیامک ارسالی نرسید
9: امکان ارسال از خطوط عمومی از طریق وب سرویس وجود ندارد.
10: پنل پیامک کاربر فعال نیست و یا پنل پیامک کاربر مسدود است.
11: ارسال نشد / شماره همراه گیرنده در لیست سیاه مخابرات است.
12: اسناد پنل اس ام اس کاربر کامل نیست.
14: شماره فرستنده پیامک نتوانست لینک را ارسال کند.
35: هنگام استفاده از REST، این به معنای وجود شماره موبایل گیرنده در لیست سیاه مخابرات است.
خطا هنگام ارسال پیامک به وب سرویس بر اساس الگوها
یکی دیگر از روش های رایج ارسال پیامک در سامانه ملی پیامک، ارسال از طریق مدل یا استفاده مشترک از خطوط خدمات سامانه از طریق وب سرویس است. در این روش نیز مانند قبل وب سرویس با ارسال پاسخ دیجیتالی شما را راهنمایی می کند تا مشکل برطرف شود. این خطاهای عددی معمولاً به شرح زیر است:
رشته ای از اعداد چند رقمی: ارسال پیامک recId که یک مقدار منحصر به فرد برای هر ارسال موفق است. (اگر recId دریافت کردید که عددی با بیش از 15 رقم است، به این معنی است که ارسال با موفقیت انجام شده است و می توانید از روش دریافت گزارش مانند GetDeliveries برای دریافت گزارش و وضعیت ارسال استفاده کنید.)
7-: در شماره فرستنده پیامک خطایی رخ داده است، لطفا با پشتیبانی فنی تماس بگیرید.
6-: یک خطای داخلی رخ داده است، لطفا با پشتیبانی فنی تماس بگیرید. (در این صورت ممکن است الگوی شما به درستی تایپ نشده باشد، یعنی به جای {} که از () یا کاراکتر دیگری در متغیرها استفاده کرده اید، یا ممکن است اعداد داخل {} را به ترتیب ننوشته باشید یا نوشته باشند. اعداد فارسی داخل { } استفاده شده است)
5-: تعداد شاخص های آرایه پارامتر متن با تعداد متغیرهای مدل شما مطابقت ندارد. (به عنوان مثال، اگر قالب شما دارای 3 متغیر باشد، چیزی در پارامتر متن تعریف نکرده اید، یا تعداد اندیس ها برابر با 3 نیست، یعنی تعداد شاخص های پارامتر متن شما می تواند 0، 1، 2 یا 0 باشد. 4 یا بیشتر.)
4-: کد متنی یا همان کد قالب یا همان کد مدل یا همان شماره قالب وارد شده صحیح نیست / کد متنی شما مورد تایید مدیر سیستم نیست.
3-: شماره فرستنده پیامک در سامانه تعریف نشده است، لطفا با پشتیبانی فنی تماس بگیرید. / شماره همراه گیرنده مجاز نمی باشد.
2-: محدود کردن تعداد شماره تلفن های گیرنده، یک شماره موبایل در هر ارسال مجاز است.
1-: دسترسی به استفاده از این وب سرویس غیرفعال شده است. لطفا با پشتیبانی تماس بگیرید.
0: پنل پیامک نمی تواند به وب سرویس متصل شود / نام کاربری یا رمز عبور وارد شده نادرست است.
1: پیامک با موفقیت ارسال شد.
2: موجودی و اعتبار پنل پیامک کافی نیست.
6: سیستم در حال به روز رسانی است.
7: متن پیامک حاوی یک کلمه یا کلمات فیلتر شده است.
10: پنل پیامک کاربر فعال نیست و یا پنل پیامک کاربر مسدود است.
11: ارسال نشد / شماره موبایل گیرنده در پنل پیامک در لیست سیاه قرار دارد.
12: اسناد پنل اس ام اس کاربر کامل نیست.
نحوه نمایش خطاهای وب سرویس در کنسول ملی اس ام اس
شاید بپرسید کنسول ملی پیامک چیست؟! برای پاسخ به این سوال پیشنهاد می کنم مقاله کنسول ملی پیامکی را مطالعه کنید.
SMS National Console سرویسی مبتنی بر REST API و Auth Token است که مخصوص توسعه دهندگان بوده و کدهای کاملاً آماده و بدون نیاز به کدنویسی ارائه می دهد. این سرویس امکان استفاده از کدهای کاملاً آماده را در وب سرویس پیامک در اختیار شما قرار داد که فقط باید پارامترهای عملکردهای مختلف آن را تنظیم کنید. اگر قصد استفاده از این سرویس را دارید یا در حال حاضر از آن استفاده می کنید، برای راحتی شما، خطاها و پاسخ های برگشتی توسط وب سرویس سیستم را ساده کرده ایم تا اگر نتیجه ای توسط وب سرویس و API برگردانده شد، فارسی را به شما نشان دهد. معنی به جای عدد
کنسول ملی اس ام اس در حال حاضر دارای نمونه زبان های برنامه نویسی زیر است که می توانید از آنها برای اتصال پنل پیامک به وب سایت، نرم افزار یا CRM خود استفاده کنید.
- php
- # درجه سانتیگراد
- جاوا (اندروید)
- Node.js
- پایتون
لیست کامل خطاهای وب سرویس پیامک در مستندات سرویس ملی پیامک
در این مقاله سعی شده است به طور خلاصه معنی تمام مقادیر برگشتی از وب سرویس و API سیستم و خطاها را بنویسیم. اگر از دیگر توابع و روش‌های پیامک ملی استفاده می‌کنید، به صفحه مستندات خدمات وب ملی پیامک برای لیست خطاهای سرویس وب برای هر روش مراجعه کنید.
نمونه هایی از کدهای پیامکی برای خدمات وب
سامانه ملی پیامک علاوه بر اینکه یکی از پیشرفته ترین سامانه های ارسال پیام کوتاه است، حدود 80 گزینه مختلف را برای مدیریت ارسال و دریافت پیامک در بستر پنل پیامک ارائه می دهد و همچنین یکی از جامع ترین و قدرتمندترین سامانه ها می باشد. برای پنل اس ام اس در حوزه خدمات وب. و SMS API نمونه کدهای بیش از 14 زبان برنامه نویسی مختلف را آماده کرده است. برای دریافت نمونه کد مورد نظر خود می توانید به صفحه ملی پیامک Github، صفحه مستندات سرویس وب و یا کنسول ملی پیامک (برای توسعه دهندگان) مراجعه کنید.
با خطاهای وب سرویس پیام کوتاه آشنا نیستید؟
اگر هنوز سوالی در ذهن شما وجود دارد یا برای رفع خطاهای وب سرویس پیام کوتاه خود به کمک بیشتری نیاز دارید، می توانید از طرق مختلف با پشتیبانی فنی تماس بگیرید. برای ارتباط با کارشناسان فنی پیامکی ملی هنگام درج تیکت در سامانه، می توانید با شماره تلفن 02163404 داخلی 1 و سپس داخلی 3 تماس گرفته و یا نظرات خود را در قسمت نظرات با ما در میان بگذارید.
