api پیام کوتاه متد دریافت لیست پیامک ها با زبان php روش NUSOAP

4 از 5 (3 نظر)

وب سرویس پیام کوتاه نمونه کد php دریافت لیست پیامک ها با nusoap

 

مقدمه
ارسال پیام کوتاه از طریق اینترنت ابزاری پر کاربرد برای استفاده تمامی مشاغل است،  با این ابزار میتوان در هر یک از مشاغل مختلف استفاده های مختلفی کرد که این استفاده ها مانند ارسال پیامک تبلیغاتی ، ارسال اس ام اس های اطلاع رسانی و ... است
ارسال پیام کوتاه از طریق اینترنت با روش های پنل کاربری ،  App موبایل و وب سرویس قابل استفاده است.
وب سرویس پیام کوتاه این امکان را به برنامه نویس ها میدهد تا بتوانند ارسال پیام کوتاه را در سایت و یا برنامه های خود به شکل سفارشی شده خود استفاده کنند.
وب سرویس پیام کوتاه قابلیت اتصال به تمامی زبان های برنامه نویسی از قبیل .NET ، JAVA ، PHP و ....  را دارد که در این مقاله قصد استفاده از وب سرویس پیام کوتاه را با زبان PHP داریم.
برای استفاده از وب سرویس پیام کوتاه در زبان php میتوان به دو روش soap و nusoap استفاده کرد که برای استفاده از روش nusoap باید کتابخانه مخصوص استفاده از آن را دانلود کنید که لینک دانلود آن در انتهای این مقاله گذاشته شده است.
برای اطلاعات بیشتر و همچنین تفاوت های روش soap و nusoap و توضیحات کامل آن میتوانید به مطالب مرتبط پایان این مقاله مراجعه کنید.
 


توضیحات فنی

وب سرویس ارسال پیامک متدی را با نامGetMessagePageing  دارد که قابلیت دریافت لیست پیامک ها  به صورت صفحه به صفحه را دارد ، با این متد میتوان لیست پیامک ها را به تفکیک ارسالی ها ، دریافتی ها ، خوانده شده ها و خوانده نشده ها و همچنین چندمین رکورد از چندمین صفحه را دریافت کرد که راهنمای کامل استفاده از آن در جدول راهنما موجود است.
 


ورودی : این متد دارای 5 ورودی میباشد

1-Signature: این ورودی از نوع string می باشد که امضای دیجیتال یا کد منحصر به فرد را دریافت می کند.
        نحوه تولید :  با  وارد شدن به پنل پیامکی خود از منوی سمت راست گزینه وب سرویس را انتخاب کرده و از منوی بالا گزینه امضا دیجیتال در دسترس است .
2-Location: این ورودی از نوع int می باشد، موقعیت پیامک که در کدام یک از حالت های ارسالی یا دریافتی یا... باشد را دریافت میکند. اطلاعات. اطلاعات کاملتر در جدول راهنما موجود است
3-IsRead: این ورودی از نوع bool می باشد ، وضعیت پیامک را دریافت میکند که اطلاعات کاملتر در جدول راهنما موجود است.
4-RowInPage: این ورودی از نوع int می باشد ، مشخص کننده این است که اطلاعات دریافتی که در قالب table است  از چندمین رکورد به بعد را برگرداند
5-StartPage: این ورودی از نوع int می باشد ، مشخص کننده این است که اطلاعات برگشتی از صفحه چند به بعد را برگرداند

خروجی : یک dataset برمیگرداند که شامل یک datatable است راهنمای کامل در جدول راهنما موجود است

مقدار راهنما 
Location (موقعیت پیام ها) موقعیت پیامک
1 : صندوق دریافت
2 : صندوق ارسال
4 : صندوق حذفی
IsRead (وضعیت پیام خوانده شده یا نشده) Null : همه
true : خوانده شده
False : خوانده نشده
در ابتدا وضعیت تمام پیامک ها به صورت خوانده نشده می باشد.
هر پیامکی که فراخوانی شد با استفاده از متد MsgChangeIsRead باید به خوانده شده تبدیل شود 
Return Value( مقدار برگشتی متد) یک dataset بر می گرداند که شامل یک dataTable است .
Columns ها :
"MsgIdEncrypt" : شناسه پیامک
"Body" متن پیامک
"Udh" : سرآمد, (کاربرد جهت ارسال بر روی پورت مانند بانک ها)
"SendDate " : تاریخ ارسال یا دریافت
 "Sender" : ستنده :
"Receiver" : گیرنده
"Parts" : تعداد بخش های پیامک
"IsFlash" : نوع پیامک ( عادی ، فلش )
"IsRead" : وضعیت پیامک ( خوانده شده ، خوانده نشده )
"IsUnicode" : پیامک فارسی یا انگلیسی
"Credit" : اعتبار واحد
"RecCount" : تعداد درخواست
"RecFailed" : تعداد ارسال ناموفق
"RecSuccess" : تعداد ارسال موفق

 


نمونه کد فراخوانی متد:

nusoap-php

مطالب مرتبط:

 

کد BSC : -70951607622192019-1052744854-11536;