یکی از قابلیتهایی که هر وبسایت بزرگی از آن استفاده میکند وبسرویس پیامک است. وبسایتها و اپلیکیشنها از وبسرویس پیامکی برای ارسال اس ام اسهای اطلاعرسانی ثبتنام و ورود کاربران، OTP و فراموشی رمز عبور، ثبت سفارشها و تغییر وضعیت سفارش، تکمیل فرم، حمل و نقل و... استفاده میکنند. در این مسیر برنامهنویسان یا توسعهدهندگان این کسبوکارها ممکن است در هنگام پیادهسازی و استفاده از وبسرویس و API پیامک، با خطا مواجه شوند. در این مقاله قصد داریم لیست خطاهای وبسرویس پیامک را در اختیارتان قرار دهیم، اما قبل از بررسی لیست خطاهای وبسرویس اس ام اس، باید بدانیم که وبسرویس چیست؟
وبسرویس و API چیست؟
وبسرویس (Web Service) یا API مخفف Application Programming Interface، یکی از اصطلاحات رایج بین برنامه نویسان است و در واقع یک رابط برنامهنویسی است که در بستر وب پیادهسازی میشود که این رابطها با استفاده از پروتکلهای استاندارد مانند http و https، تابعها و مکانیزمها و عملکردهای مختلفی را در اختیار برنامهنویسان قرار میدهند. وبسرویس همانند یک پل ارتباطی است که برای تبادل اطلاعات بین نرمافزارها و سایتهای مختلف توسط سازمان W3C توسعه داده شده است. وبسرویس پیامک، مانند آن پل ارتباطی است که برای ارسال پیامکهای اطلاعرسانی سایت، اپلیکیشن، نرمافزار یا CRM به مدیران و مشتریان شما، مورد استفاده قرار میگیرد.
مطالعه مقاله "وب سرویس و API چیست؟" به شما برای درک بهتر وب سرویس کمک خواهد کرد.
برنامهنویس، توسعهدهنده وبسایت یا نرمافزار شما، همگی میتوانید از انواع وبسرویس ملی پیامک استفاده کنید. ملی پیامک یکی از قدرتمندترین و جامعترین سامانههای پیامکی است که به شما امکان مدیریت پیامکهای ارسالی، smsهای دریافتی، پیامهای زماندار، دفترچه تلفن، پیام صوتی و... را میدهد. با دانستن خطاهای وبسرویس پیامک شما میتوانید در صورت بروز مشکل به راحتی مورد را مرتفع نمائید.
انواع وبسرویسهای پیامکی
قبل از معرفی خطاهای وبسرویس پیامک بهتر است با انواع وب سرویس و API سامانۀ ملی پیامک آشنا شوید. به طور کلی متدها و توابع وبسرویس ملی پیامک به 8 دسته کلی زیر تقسیم میشود:
لیست خطاهای وب سرویس پیامک
از آنجایی که گردآوری همۀ خطاهای ممکنالوقوع در وب سرویس اس ام اس خارج از حوصله این مقاله است و تمامی اطلاعات مورد نیاز شما نبز در صفحه مستندات وب سرویس پیامک وجود دارد، در زیر و به اختصار فقط خطاهای وب سرویس ارسال پیامک (وبسرویس عادی و ارسال از خط اختصاصی) و خطاهای وب سرویس ارسال پیامک بر اساس پترن و الگو (وبسرویس خدماتی) را لیست کردهایم. برای درک بهتر تفاوتهای ارسال پیامک از خط اختصاصی و و ارسال پیامک از خط خدماتی-اشتراکی، نظر شما را به تعریف کوتاه هر کدام جلب میکنیم.
خط اختصاصی: هر یک از پنلهای سامانه ملی پیامک، دارای حداقل 1 خط مجازی فرستنده پیامک یا همان سرشماره پیام کوتاه است که این خطوط معمولاً بهصورت تبلیغاتی فعال میشوند و امکان ارسال اس ام اس به افرادی که پیامکهای تبلیغاتی سیمکارت خودشان را مسدود کردهاند(لیست سیاه مخابرات) ندارند.
خط خدماتی: این خطوط با ارائه مدارک خاص، از سوی اپراتورها از حالت تبلیغاتی به حالت خدماتی تغییر مییابند و به شما امکان ارسال پیامک به آن دسته از مخاطبینی که در لیست سیاه مخابرات قرار دارند را نیز میدهد. پیشنهاد میکنم برای کسب اطلاعات بیشتر به صفحه "خط خدماتی چیست؟" مراجعه کنید.
خطاهای وب سرویس ارسال پیامک
پس از اینکه از وبسرویس ملی پیامک استفاده کردید، عددی را در پاسخ درخواست وب سرویس و API به شما از سوی سامانه ملی پیامک نمایش میدهد، که این اعداد معانی مختلفی دارند. در جدول زیر به معانی این اعداد میپردازیم:
در استفاده از وب سرویس پیامکی با خطایی مواجه شدید؟
خطاهای وب سرویس ارسال پیامک بر اساس پترن (الگو)
یکی دیگر از متدهای پرطرفدار ارسال پیامک در سامانه ملی پیامک، ارسال از طریق پترن (الگو) یا همان استفاده اشتراکی از خطوط خدماتی سامانه با استفاده از وبسرویس است. در این روش نیز همانند قبل وبسرویس به شما به واسطۀ ارسال پاسخ عددی برای رفع مشکل راهنمایی میکند. این خطاهای عددی معمولا به شرح زیر است:
خطایی در هنگام اتصال به وب سرویس پترن برایتان پیش آمد؟
نحوه نمایش خطاهای وبسرویس در کنسول ملی پیامک
کنسول ملی پیامک یک سرویس بر پایه REST API و Auth Token است که مخصوص برنامهنویسان بوده و قطعه کد کاملاً آماده و بدون نیاز به کدنویسی را ارئه میکند. این سرویس به شما امکان استفاده از قطعه کدهای کاملاً آماده در وب سرویس پیامک را فراهم کرده است که تنها نیاز به مقداردهی به پارامترهای توابع مختلف آن را دارد. در صورتی که قصد استفاده از این سرویس را دارید یا در حال استفاده از آن هستید، برای راحتی کار شما خطاها و پاسخهای بازگشتی از سوی وب سرویس سامانه را سادهسازی کردهایم، بهگونهای که اگر هر نتیجهای از سوی وبسرویس و API بازگشت داده شود، بهجای عدد معنی فارسی آن را برایتان نمایش خواهد داد.
لیست کامل خطاهای وبسرویس پیامک در مستندات وبسرویس ملی پیامک
در این مقاله سعی کردیم بهطور خلاصه معنی تمامی مقادیر بازگشتی از سوی وبسرویس و API سامانه و خطاها را برایتان بنویسیم. اگر شما در حال استفاده از دیگر توابع و متدهای ملی پیامک هستید، برای مشاهده لیست خطاهای وب سرویس هر متد به صفحۀ "مستندات وب سرویس ملی پیامک" مراجعه نمائید.
نمونه کدهای وب سرویس پیامک
سامانه ملی پیامک علاوهبر اینکه یکی از پیشرفتهترین سامانههای ارسال پیام کوتاه است که در کنار حدود 80 امکان مختلف برای مدیریت ارسال و دریافت پیامک در بستر پنل اس ام اس فراهم کرده است، یکی از جامعترین و قدرتمندترین سامانههای پنل پیامکی است که در حوزه وب سرویس و API پیامکی، برای بیش از 14 زبان برنامهنویسی گوناگون، نمونه کدها را آماده کرده است. برای دریافت نمونه کد مورد نظر خود میتوانید به صفحه گیتهاب ملی پیامک، صفحه مستندات وب سرویس یا کنسول ملی پیامک(مخصوص برنامهنویسان) مراجعه کنید.
خطاهای وبسرویس پیامک برای شما ناشناخته است؟
اگر همچنان سوالی در ذهنتان باقی مانده یا برای رفع خطاهای وبسرویس پیامک خود نیاز به راهنمایی بیشتری دارید، میتوانید به طرق مختلف با پشتیبانی فنی در ارتباط باشید. جهت ارتباط با کارشناسان فنی ملی پیامک، ضمن درج تیکت در داخل سامانه، میتوانید با شماره 02163404 داخلی 1 و سپس داخلی 3 تماس بگیرید یا نظرات خود را در قسمت دیدگاهها با ما به اشتراک بگذارید.
لغو پاسخ
سلام
این دو خطا به چه علت هستند؟
int(6)
int(-110)
سلام دوست عزیز،
int(-110) یعنی: استفاده از مقدار APIKey بهجای رمز عبور، الزامی هست. لطفاً بهجای رمز عبور پنل پیامک، از مقدار API KEY توی وب سرویس استفاده کنید.
int(6) یعنی: سامانه درحال بروزرسانی است؛ بعداً تلاش کنید.
به به
سلام چراگزینه ارسال پیامک بازنمیشه همه کارم کردم
درود بر شما،
دقیقا کجا رو دارید میگید؟ اگر میخواید خیلی زود بهتون کمک کنیم، با شماره 02163404 تماس بگیرید.
در هنگام ارسال تستی کد ارسال ارسال نمیشه و خطای زیر نشون داده میشه:
11
بخش تیکت هم مشکل دارد و تیکت ارسال نمیشود
درود بر شما،
خطای 11 معمولا دو تا دلیل داره: اگر دارید با خط اختصاصی تبلیغاتی تون این کار رو انجام میدید احتمالا به خاطر تبلیغاتی بودن، به بلک لیست ارسال نشده.
و یا ممکنه تو بازه 10 شب تا 8 صبح ارسال رو انجام داده باشید که ارسال پیامک ممنوعه. باز اگر سوالی دارید با پشتیبانی به شماره 021634504 زنگ بزنید.
سلام وقت بخیر
میخوام بدونم من میتونم از شما تست دریافت کنم؟
میخوام روی لوکال استفاده کنم
باتشکر
درود بر شما
میتوانید اقدام به ثبت نام بفرمایید و سپس با شماره تماس 021-63404 تماس حاصل نمایید تا یک پنل تست 3 روزه برای شما در نظر گرفته شود.
سلام و سپاس از مقاله های خوبتون
خیلی جامع و کامل هستند
سوالی که دارم این خطا ها ایا مربوط به کنسول ملی پیامک هم هست یا برای خطای مربوط به کنسول ملی پیامک مقاله ی جداگانه دارید در صورتی که هست لطفا لینک ان را برای بنده ارسال نمایید
درود بر شما
ممنون بابت ثبت نظرتون!
پاسخ های بازگشتی در کنسول به صورت متنی بوده و نیازی به ترجمه ندارد.
روزبخیر
من درکنسول خطای به تنظیمات مراجعه کنید میگیرم
میشه بفرمایید دقیقا کدام بخش باید بررسی کنم؟
ممنون از راهنمایی شما.
درود بر شما
لطفا در کنسول بخش “حساب کاربری”->”تنظیمات “مراجعه بفرمایید.
با سلام وقت شما بخیر یه سوال کوچیک از شما داشتم کارشناس محترم ایا برای api key باید هزینه ای پرداخت شود؟
درود بر شما
خیر ! برای دسترسی به api key (جایگزین رمز عبور) به بخش “تنظیمات” ->”تنظیمات” قسمت “APIKey جهت استفاده از وبسرویس” مراجعه بفرمایید.
سلام ممنون از شما خیلی مقاله مفید و خوبی بود . فقط یک موردی که هست من انروز برای سایتم وب سرویسش رو فعال کردم اما مقدار بازگشتی 1 می داد که یعنی ارسال با موفقیت انجام شده اما چیزی به دست خودم نمی رسید میشه لطفا بگید این مشکل رو چطوری حل کنم ؟ ممنون از شما
درود بر شما
در صورتی که با اختصاصی تبلیغاتی خود اقدام به ارسال پیامک نموده اید، در نظر داشته باشید خطوط تبلیغاتی امکان ارسال به بلک لیست را ندارد.
بابت این مورد میتوانید از ارسال از طریق خطوط خدماتی اشتراکی یا همان ارسال از طریق الگو و پترن ارسال بفرمایید.
سلام و خسته نباشید
ما میخواهیم پنلی داشته باشیم که هم از ان برای اتصال به سایتمان استفاده کنیم تا پیامک ثبت سفارش و کدتایید ارسال بشه و هم میخواهیم تبلیغات منطقه ای داشته باشیم ایا با خرید یک پنل میشه از هر دو مورد استفاده کرد؟
سلام، سلامت باشید!
به با خرید یکی از پنل هایی که امکان اتصال به وبسرویس را دارند تهیه و استفاده بفرمایید.
سلام من می تونم از خط ثابت خودم پیامک ارسال کنم و این خط رو به نرم افزار خودمم اتصال بدم ما یک شرکت ثبت شده هستیم که یک خط ثابت 5 رقمی داریم میخوایم پیامک از طریق این خط ارسال بشه و برای نرم افزار داخلی نیز استفاده بشه در صورت امکان لطفا توضیحاتی به ایمیل من ارسال نمایید
درود بر شما
این مورد امکان پذیر است، لطفا درخواست خود را به ایمیل
info@melipayamak.com ارسال بفرمایید تا راهنمایی های لازم صورت گیرد.
درود
بنده خطای 0 از وب سرویس ملی پیامک دریافت میکنم مطمئن هستم نام کاربری و رمز عبور را صحیح وارد میکنم اما قسمت مربوط به این نکته (پنل اس ام اس امکان اتصال به وب سرویس را ندارد) از کجا میتونم این مورد پیگیری کنم؟
کدوم پنل امکان وب سرویس را به طور کل پشتیبانی میکنه؟
ممنون از راهنمایی جنابعالی
درود بر شما
همه پنل ها به جز پنل پایه امکان اتصال به وبسرویس را دارند، در صورتی که پنل پایه را تهیه نموده اید و نیاز به اتصال به وب سرویس را دارید میتوانید از طریق پشتیبانی (تیکت) اقدام به ارتقای پنل خود بفرمایید.
سلام خسته نباشید من در افزونه گرویتی فرم مشکل دارم تنظیمات را به درستی انجام دادم و خطایی هم دریافت نمیشه اما پیام با خط اختصاصی پنلم ارسال میشه و همینطور به درستی متن ارسال نمیشه طبق همون الگویی که ثبتش کردم در تنظیمات افزونه ارسال میشه. نمیدونم چجوری این مشکل رو برطرف کنم
سلام سلامت باشید!
به نظر افزونه شما در تشخیص الگو مشکل دارد ، حتما از صحیح بودن الگو خود اطمینان حاصل بفرمایید و از افزونه ارسال پیامک گرویتی فرم داخل سایت ملی پیامک نیز حتما استفاده بفرمایید.
در صورتی که این مورد برای شما مرتفع نگردید، از طریق پشتیبانی (تیکت) این مورد را پیگیری بفرمایید.
طبق بررسی هایی که داشتم روی سایت شما به موردی به اسم کنسول برخورد کردم آیا امکانش هست از کنسول ملی پیامک بازدید داشت؟ آیا پنل دمو برای این مورد وجود داره؟
درود بر شما
متاسفانه کنسول حالت دمو ندارد ولی در صورتی که پنلی از ملی پیامک دارید ، دسترسی به کنسول برای شما رایگان خواهد بود و نیاز به پرداخت هزینه ندارد.
یه سری خطا هستش که من از سمت افزونه پیامک ووکامرس میگیرم. این خطا ها خیلی طولانی هستش، خداروشکر به بخش پشتیبانی گفتم مشکل رو حل کنه و در نهایت درست شد ولی نگفتن مشکل از کجا بوده.
میشه برام توضیح بدین؟
درود بر شما
شما میتوانید در همان تیکت گذاشته شده بابت رفع خطا، درخواست توضیح خطا را دهید ، پشتیبانی پاسخگوی شما خواهد بود.
سلام دوست عزیز
وقتتون بخیر
بله این مورد کاملاً درست هست و مبحث ارور هندلینگ در کنسول ملی پیامک رعایت شده.
برچسب ها: