کدهای خطای وب‌سرویس پیامک؛ معنی هر خطا و راه‌حل آن

وب‌سرویسی که فقط بگوید «خطا»، برنامه‌نویس را ساعت‌ها سرگردان می‌کند. در درگاه پیامک (SMSGate) بدنهٔ همهٔ پاسخ‌ها یک قالب ثابت دارد:

{ "code": 164, "message": "موجودی کافی نیست", "data": {} }

code برای موفقیت ۱۰۰ است و خطاها از ۱۰۱ شروع می‌شوند. برنامه‌تان را بر اساس این عدد بنویسید و message را که توضیح فارسی خطاست، برای لاگ و پشتیبانی نگه دارید. در ادامه، کدها را به‌ترتیب موضوع مرور می‌کنیم.

کلید API و IP

حساب کاربری

داده‌های درخواست

خط فرستنده و گیرندگان

موجودی و پرداخت

خطاهای موقت: دوباره تلاش کنید، ولی درست

برای خطاهای موقت، تکرار با فاصلهٔ فزاینده (مثلاً ۲، ۴ و ۸ ثانیه) و تعداد محدود را پیاده کنید. خطاهای ۴xx مثل داده یا کلید نامعتبر را تکرار نکنید؛ با تکرار درست نمی‌شوند و فقط لاگ را شلوغ می‌کنند.

پاسخ «پذیرفته» با وضعیت pending: گاهی پاسخ موفق است، ولی وضعیت ارسال به‌جای enqueued، pending است؛ یعنی ارسال ثبت شده اما هنوز به صف نرسیده. این خطا نیست؛ همان درخواست را دوباره نفرستید، وگرنه پیام تکراری ارسال می‌کنید.

جمع‌بندی

بیشتر خطاهای وب‌سرویس در سه دسته‌اند: کلید و IP، داده و خط، و موجودی. هرکدام راه‌حل روشنی دارد. اگر خطایی برطرف نشد، با ثبت تیکت پشتیبانی و فرستادن کد خطا، زمان درخواست و بدنهٔ آن (بدون کلید API) سریع‌تر به جواب می‌رسید. مستندات کامل در doc.webservice.ir است.