پیامک‌های دریافتی با ارسال شناسه

برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرس‌های زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:

wsdl http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl

non-wsdl http://sms.sunwaysms.com/SMSWS/SOAP.asmx
متد GetInboxMessageWithInboxID

با استفاده از این متد شما می توانید با ارسال شناسه یک پیامک، لیستی از تمامی پیامک های دریافتی که شناسه آن ها بزرگتر از شناسه پیامک ارسالی باشد، را دریافت نمایید . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید :

https://sms.sunwaysms.com/smsws/HttpService.ashx?service=GetInboxMessageWithInboxID&username=$UserName$&password=$Password$&NumberOfMessage=$NumberOfMessage$&InboxID=$InboxID$&IsReaded=$IsReaded$

پارامترهای ورودی

نام پارامترنوعاجباری/اختیاریتوضیح
UserNameStringاجبارینام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
PasswordStringاجباریکلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
NumberOfMessageIntegerاجباریتعداد پیامک های درخواستی
InboxIDIntegerاجباریشناسه پیامک
IsReadedBooleanاجباریآیا تمامی پیامک ها نمایش داده شود یا فقط خوانده نشده ها؟ در متد دریافت پیامک های ورودی جهت دسترسی به تمامی پیامک های دریافتی یا فقط پیامک های دریافتی خوانده نشده به کار می رود. اگر مقدار این پارامتر را برابر False قرار دهید تنها پیامک های دریافتی که خوانده نشده اند نمایش داده می شود ولی اگر مقدار آن را برابر با True قرار دهید تمامی پیامک ها شامل پیامک های خوانده شده و خوانده نشده نمایش داده می شود .
UserName
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
Password
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
NumberOfMessage
از نوع Integer (اجباری)
تعداد پیامک های درخواستی
InboxID
از نوع Integer (اجباری)
شناسه پیامک
IsReaded
از نوع Boolean (اجباری)
آیا تمامی پیامک ها نمایش داده شود یا فقط خوانده نشده ها؟
در متد دریافت پیامک های ورودی جهت دسترسی به تمامی پیامک های دریافتی یا فقط پیامک های دریافتی خوانده نشده به کار می رود. اگر مقدار این پارامتر را برابر False قرار دهید تنها پیامک های دریافتی که خوانده نشده اند نمایش داده می شود ولی اگر مقدار آن را برابر با True قرار دهید تمامی پیامک ها شامل پیامک های خوانده شده و خوانده نشده نمایش داده می شود .

مقدار بازگشتی

نوع خروجیتوضیحات
خروجی Jsonآرایه Messages شامل اطلاعات پیامک های دریافتی
- InboxID شناسه پیامک دریافتی
- SpecialNumber شماره اختصاصی ( شماره ای پیامک را دریافت کرده است )
- SenderNumber شماره فرستنده ( شماره موبایل فرستنده پیامک )
- MessageBody متن پیامک
- ReceiveDate تاریخ و ساعت دریافت پیامک
- UDH سرآیند پیامک دریافتی
- Status کد خطا (رجوع شود به بخش 5)

کدهای وضعیت پیامک

کدتوضیحات
0 شناسه پیامک نامعتبر است ( یا ممکن است شناسه پیامک ارسال شده مربوط به پیامکی باشد که بیش از یک ماه از ارسال آن می گذرد )
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
1 هنوز وضعیتی دریافت نشده است ، سیستم در حال پیگیری وضعیت پیامک از مخابرات است
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
2 پیامک به موبایل گیرنده رسیده است وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
3 پیامک به موبایل گیرنده نرسیده است ، به یکی از دلایل ذیل :
  • پر بودن Inbox موبایل گیرنده پیام
  • خاموش بودن موبایل گیرنده پیام
  • در دسترس نبودن موبایل گیرنده پیام
  • اختلال در شبکه BTS
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
4 پیامک به مرکز مخابراتی رسیده است ( در صف ارسال مخابرات قرار گرفته است و بزودی به موبایل گیرنده ارسال می گردد )
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
5 پیامک به مرکز مخابراتی نرسیده است ( این وضعیت زمانی رخ می دهد که مرکز مخابراتی نتواند به اپراتور تلفن همراه شماره گیرنده ، پیامک ارسال کند )
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
6 شماره موبایل گیرنده پیامک به درخواست کاربر در لیست غیر فعال مخابرات قرار گرفته است
هزینه این ارسال به کاربر برگردانده می شود
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
7 پیامک در صف ارسال قرار دارد ( سرور هنوز شروع به ارسال پیامک نکرده است )
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
8 سرور در حال ارسال پیامک می باشد
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
9 در زمان ارسال به علت کمبود اعتبار پیام کوتاه ، این پیامک ارسال نشده است
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
10 پیامک ارسال نشده است ( به دلیل اختلالات ارتباطی پیامک ارسال نشده است اما سرور به مدت 2 ساعت تلاش به ارسال مجدد این پیامک می کند و اگر طی این 2 ساعت نتواند پیامک را ارسال کند ، هزینه آن را به کاربر برمی گرداند
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
11 پیامک هنوز توسط اپراتور تأیید نشده است
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
12 پیامک در لیست کنسل شده یا فیلتر شده قرار دارد
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود

کدهای خطا

در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .

توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .

کد خطاتوضیحات
51نام کاربری یا رمز عبور اشتباه است
52نام کاربری یا رمز عبور خالی است
60در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید
63این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید )
65کلید NumberOfMessage اشتباه است ( مقدار آن منفی است )
70کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید )
77شما کاربر وب سرویس نیستید
80در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید )
400تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است.
666سرویس موقتاً غیر فعال است
777این IP مسدود است
1 رای ثبت شده
سان‌وی
ویرایش محتوا
پشتیبانی سامانه پیامک

خیلی زود با شما تماس خواهیم گرفت

از طریق تلفن و واتس‌اپ هم می‌توانید با ما تماس بگیرید

در سریع‌ترین زمان پاسخ سوال شما را برای‌تان ارسال خواهیم کرد

ویرایش محتوا

سامانه پیامک و وب‌سرویس هدیه

در کمتر از یک دقیقه یک سامانه پیامک و وب‌سرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید