شروع کار

کدهای خطا

مقدار return.status نتیجه هر درخواست را مشخص می‌کند. ۲۰۰ یعنی موفقیت؛ هر کد دیگری علت رد شدن درخواست است و در آن حالت هیچ پیامی ارسال نشده و اعتباری کم نشده است.

خطاهای عمومی

کدمعنیراه رفع
200 درخواست با موفقیت انجام شد.
400 پارامترها ناقص هستند. پارامترهای الزامی صفحه همان متد را بررسی کنید.
401 حساب غیرفعال است. با پشتیبانی تماس بگیرید.
402 عملیات ناموفق بود.
403 کلید API نامعتبر است. کلید را دوباره از پنل مشتریان کپی کنید؛ فاصله اضافه در ابتدا یا انتها رایج‌ترین علت است.
404 متد ناشناخته است. مسیر را با مسیر صفحه همان متد مقایسه کنید؛ پسوند .json را فراموش نکنید.
405 متد HTTP اشتباه است (GET به جای POST یا برعکس).
406 پارامترهای الزامی خالی ارسال شده‌اند.
407 دسترسی به این اطلاعات مجاز نیست. متدهای گزارش‌گیری به دسترسی IP نیاز دارند؛ صفحه محدودیت‌ها و دسترسی را ببینید.
409 سرور فعلا قادر به پاسخ نیست. چند ثانیه بعد دوباره تلاش کنید.
411 گیرنده نامعتبر است.
412 فرستنده نامعتبر است، یا تعداد آیتم‌ها از سقف مجاز بیشتر است. از خطی استفاده کنید که روی حساب شما فعال است.
413 متن پیام خالی یا بیش از حد طولانی است. حداکثر ۱۸۰۰ کاراکتر (۴۰۰۰ کاراکتر برای خطوط پیام‌رسان داخلی).
414 تعداد رکوردها از سقف مجاز یک درخواست بیشتر است. ارسال حداکثر ۲۰۰ گیرنده و استعلام وضعیت حداکثر ۵۰۰ شناسه.
415 اندیس شروع از تعداد کل رکوردها بیشتر است.
416 IP مبدا با تنظیمات حساب مطابقت ندارد.
417 تاریخ نامعتبر است یا فرمت آن اشتباه است. تاریخ‌ها UnixTime به ثانیه هستند، نه میلی‌ثانیه. محدوده بازه را در صفحه همان متد ببینید.
418 اعتبار حساب کافی نیست. از بخش اعتبار پنل مشتریان حساب را شارژ کنید.
419 طول آرایه‌های متن، گیرنده و فرستنده برابر نیست.
420 استفاده از لینک در متن پیام برای حساب شما محدود شده است.
422 داده‌ها به دلیل کاراکتر نامناسب قابل پردازش نیستند.
424 قالب پیدا نشد. نام قالب را بررسی کنید و مطمئن شوید تایید شده است.
426 استفاده از این متد به سرویس پیشرفته نیاز دارد. برای فعال‌سازی با پشتیبانی تماس بگیرید.
427 استفاده از این خط به تنظیم سطح دسترسی نیاز دارد.
428 ارسال کد با تماس صوتی برای این توکن ممکن نیست. تماس صوتی فقط توکن عددی را می‌پذیرد.
429 IP محدود شده است.
431 فرمت توکن نامعتبر است. توکن نباید خط جدید، فاصله یا _ داشته باشد.
432 پارامتر %token در متن قالب پیدا نشد.
451 به دلیل درخواست‌های بیش از حد، IP موقتا محدود شده است. درخواست‌ها را دسته‌ای بفرستید (هر درخواست تا ۲۰۰ گیرنده) به جای یک درخواست برای هر شماره.
501 فقط ارسال آزمایشی به شماره صاحب حساب مجاز است. حساب هنوز در حالت آزمایشی است؛ با پشتیبانی تماس بگیرید.

لیست سیاه و برچسب

کدمعنیراه رفع
604 تعداد شماره‌ها در درخواست لیست سیاه بیش از ۲۰۰ است.
607 نام برچسب (tag) نامعتبر است. برچسب باید از قبل تعریف شده باشد و فقط حروف انگلیسی، عدد، - و _ داشته باشد.

فایل‌های چندرسانه‌ای

کدمعنیراه رفع
800 فایل ارسال نشده است.
801 فایل نامعتبر است یا قابل پردازش نیست.
802 حجم فایل مجاز نیست.
803 نسبت ابعاد فایل مجاز نیست.
804 مدت ویدیو مجاز نیست.
805 اجازه آپلود فایل ندارید.
806 سهمیه آپلود تمام شده است.
807 این فایل قبلا آپلود شده است.
808 شناسه فایل نامعتبر است.
809 فایل پیدا نشد.
810 فایل در انتظار بررسی است.
811 فایل در بررسی رد شده است.
812 فایل در سیاست ارسال انتخاب‌شده مجاز نیست.
813 ارسال فایل فقط روی خطوط پیام‌رسان داخلی ممکن است.

کدام خطاها را دوباره امتحان کنیم

  • 409 و 451 موقتی هستند؛ با فاصله زمانی رو به افزایش (مثلا ۵، ۱۵ و ۶۰ ثانیه) دوباره بفرستید.
  • بقیه کدها با تکرار درخواست برطرف نمی‌شوند؛ پارامتر، کلید یا اعتبار را اصلاح کنید.
  • اگر پاسخی نگرفتید (قطع شبکه یا timeout)، پیش از ارسال دوباره با localid و statuslocalmessageid بررسی کنید پیام ثبت شده یا نه، تا پیام دوبار ارسال نشود.