|
در این روش، با استفاده از استاندارد SOAP برای فراخوانی از
راه دور سرویس ها امکان فرستادن، دریافت و یا گزارش گیری از وضعیت
پیام های ارسالی فراهم می گردد. تفاوت اصلی این روش با روش URL در
استفاده از SOAP به عنوان روش کد کردن درخواستها و پاسخها به جای
استفاده از HTTP URL می باشد. علی رغم پیچیدگی بیشتر فراخوانی این
روش به جای URL، بیشتر محیط های برنامه نویسی از این روش پشتیبانی
می کنند. این روش اجازه درخواستهای پیچیده تری نسبت به URL می دهد
و در نتیجه امکان بیشتری برای توسعه API می دهد.
متدهای ارائه شده :
-تغيير رمز عبور :
با فراخواني متد زير كاربر مي تواند رمز عبور دسترسي به سرويس خود را تغيير دهد :
short changePassword(String username, String currentPassword, String newPassword);
-ارسال يك پيام به يك يا چند شماره :
با فراخواني متد زير كاربر مي تواند يک پيام را به يک يا چند شماره ارسال نمايد :
SendResult send(String userName,String password,String shortNumber,String[] destNo,String sourcePort,String destPort,String clientId[],short messageType,short encoding,boolean longSupported,Date dueTime,String content);
- ارسال پيام هاي متفاوت به شماره هاي مختلف :
با فراخواني متد زير كاربر مي تواند يک يا چند پيام را به يک يا چند شماره ارسال نمايد :
SendResult sendMultiple(String userName, String password, String shortNumber, String sourcePort, String destPort, short messageType, boolean longSupported, MessageObject[] messages, Date dueTime);
- دريافت پيامها :
با فراخواني متد زير کاربر می تواند پيام های خود را دريافت نمايد :
ReceiveResult receive(String userName, String password, String shortNumber, long start, int maxSize);
- گرفتن وضعيت پيام :
با فراخواني متد زير کاربر می تواند وضعيت پيام ارسالي خود را دريافت نمايد. براي اين منظور بايستي شماره پيام را به سيستم ارسال نمايد. سيستم در جواب آن يك كد وضعيت را بر خواهد گرداند :
short getStatus(long messageId);
- گرفتن ميزان اعتبار :
با فراخواني متد زير کاربر می تواند اقدام به گرفتن ميزان اعتبار خود براي ارسال يا دريافت پيام نمايد :
BalanceResult getBalance(String userName,String password,short facilityId);
- دریافت Delivery Receipt :
با فراخوانی تابع مربوط به دریافت وضعیت پیام، میتوان از وضعیت پیامهای ارسال شده آگاهی پیدا کرد :
ReportResult report(String userName,String password,String shortNumber,String fromClientId,String clinetId,String fromId,String id,int maxSize);
- دریافت Delivery Receipt :
با فراخوانی تابع مربوط به دریافت وضعیت پیام، میتوان با ارسال شماره شناسه های پیامهای ارسال شدهاز وضعیت پیامها آگاهی پیدا کرد :
ReportResult statusReport(String userName,String password,String shortNumber,String type,Long[] id, String[] clinetId);
|