سرویس API پیامدهی
کدهای بازگشتی
جدول کدهای بازگشتی
در صورت موفقیت، کد رهگیری (عدد بزرگتر از ۱۰۰۰) از مخابرات بازگردانده میشود.
برای خط جدید در متن پیام از \n استفاده کنید.
| کد | شرح |
|---|---|
| متن پیامک معتبر نیست | |
| توکن API، نام کاربری، کلمه عبور یا کد پرتال معتبر نیست | |
| شماره موبایل معتبر نیست | |
| خطای داخلی وبسرویس — به پشتیبانی گزارش کنید | |
| اعتبار/شارژ کافی نیست یا محدودیت ارسال | |
| ارسال پیام تکراری تا ۵ دقیقه مجاز نیست | |
| محدودیت ارسال با مرجع بلکلیست — کمی صبر کنید | |
| مرجع ارسال نامعتبر — مقادیر فعال: 1، 4، 6، 100 | |
| شماره فعال نیست — فرم WhoIS مخابراتی را تکمیل کنید | |
| متن حاوی کلمات یا حروف غیرمجاز | |
| برای پیام حاوی لینک، پروفایل WhoIS را تکمیل و تأیید کنید | |
| برای ارسال از شماره عمومی، پروفایل WhoIS را تکمیل کنید | |
| خطای نامشخص — به پشتیبانی گزارش دهید | |
| شماره در لیست سیاه پرتال شما | |
| شماره در لیست سیاه مشترک سیستم | |
| شماره مرجع 5000 برای ارسال معتبر نیست | |
| متن حاوی کلمات غیرمجاز | |
| شماره در لیست سیاه مخابرات | |
| شماره مرجع 9821 برای ارسال معتبر نیست | |
| متن و شماره تکراری — چند ثانیه صبر کنید | |
معمولاً بهدلیل پارامتر نامعتبر (موبایل، متن طولانی، سرشماره، WhoIS و …). کد خطا را با ServerType به پشتیبانی (تیکت) ارسال کنید. |
نکات
- برای اتصال نرمافزارهای حسابداری از بخش «اتصال سایر نرمافزارها» استفاده کنید: نام کاربری = توکن API، کد پرتال = پارامتر PortalCode.
- اتصال مستقیم فقط وقتی ممکن است که نرمافزار اجازه تعریف URL و پارامترهای دلخواه را بدهد؛ در غیر این صورت افزونه/واسط اختصاصی لازم است.
- ServerType=100 برای ارسال عمومی و OTP (لیست سیاه مخابرات) توصیه میشود.
- پاسخ موفق: عدد بزرگتر از ۱۰۰۰؛ هر عدد دیگر کد خطاست.
- برای پیام حاوی لینک یا ارسال از شماره عمومی، پروفایل WhoIS باید تکمیل و تأیید شده باشد.
- برای تست سریع REST API، URL را با پارامترها در مرورگر باز کنید.
- در صورت خطا، کد بازگشتی و ServerType را در تیکت پشتیبانی ذکر کنید.