هاتوک مایپ لاسرا یاهسیورس بو زا هدافتسا...

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

1392 تیر –آخرین ویرایش

شرح هتذ ها و پاراهترهای ارسال و دریافت پیام کوتاه تا استفاده از وب سرویس خذهات پیام کوتاه

شرکت عصر فرا ارتثاط

فهرست هطالة

1 ....................................................................................................................................... :مقذمه

1 ........................................................................................................... پایه اصطالحات و مفاهیم

Message .................................................................................................... 1

Businesscard ........................................................................................ 2

Flash message .................................................................................... 2

Wappush .................................................................................................. 2

Short code............................................................................................... 2

Username ................................................................................................ 3

Password .................................................................................................. 3

ID ...................................................................................................................... 3

Mobile .......................................................................................................... 3

4 ............................................................. :ارتباط فرا عصر شرکت سىی از شذه ارائه سرویسهای وب

4 ....................................................................... (Box Service )4 نسخه پیامک ارسال سرویس وب

sendBusinessCard ........................................................................................................... 4 متذ

sendMessage ................................................................................................................. 7 متذ

sendWappush ................................................................................................................ 9 متذ

11......................................................................(web service )1 نسخه پیامک ارسال سرویس وب

GetRemainingCredit ......................................................................................................12 متذ

SendMessage ................................................................................................................12 متذ

15...................................................................... (Box Service )5 نسخه پیامک ارسال سرویس وب

SendMessage ................................................................................................................15 متذ

GetMessageStatus .........................................................................................................17 متذ

GetMessagesStatus .......................................................................................................18 متذ

19....................................................................(BoxService )7 نسخه پیامک ارسال سرویس وب

SendMessage ................................................................................................................20 متذ

GetMessageID ...............................................................................................................22 متذ

GetMessageStatus .........................................................................................................23 متذ

GetMessagesStatus .......................................................................................................23 متذ

GetRemainingCredit ......................................................................................................25 متذ

SendMessagePeerToPeer ...............................................................................................25 متذ

26..................................................................................... سرویس وب متذهای با کار کلی روال

Query String ...........................................................................................27 طریق از پیامک ارسال

28......................................................................... :پیامک ارسال وبسرویسهای به راجع مهم نکات

30..................................................................... (Inbox Service )1 نسخه پیامک دریافت وبسرویس

Get ...............................................................................................................................30 متذ

GetFirst .........................................................................................................................31 متذ

GetLast .........................................................................................................................32 متذ

GetNext ........................................................................................................................33 متذ

GetPerior ......................................................................................................................35 متذ

List................................................................................................................................36 متذ

GetCount ......................................................................................................................37 متذ

38..............................................................................:پیامک دریافت وبسرویس به راجع مهم نکات

HTTP ...................................................................................39 پروتکل از استفاده با پیامک دریافت

1

:هقذهه

ضز یاظ تطای اضؾال زضیافت قطکت ػهط فطا اضتثاط اضائسس ؾطیؿای پیام کتا طم افعاضای ه

ؾظ ایي قطکت اضائ هیكس ک اظ آى جول هیتاى ت . پیاهک زض ؾطاؾط کكض هیثاقس ؾطیؿای هتؼسزی ت

ایي ؾطیؽ قاهل اتعاضائی اؾت ک ت تطاهیؿاى اهکاى هیسس تا تا . ؾطیؽ یػی تطاهیؿاى اقاض کطز

زض .ضا زض تطاهای ذز فطان کس پیاهک قاتلیت اضؾال زضیافت (زض حس چس ذظ کس) کسیؿی هیعاىکوتطیي

.تركای تؼس ت هؼطفی ایي ؾطیؿا هیپطزاظین

هفاهین و اصطالحات پایه

.زض ایي ترف ت تكطیح ػثاضات انغالحاتی هیپطزاظین ک ت کطات زض ایي ضاوا اظ آا ام تطز قس اؾت

تایل ذهنا اضؾال پیاهک پطکاضتطز ؿتس :اتتسا ت انغالحاتی هیپطزاظین ک زض نؼت ه

Message : پیاهک(sms) - پیاهک زاضای یػگیا هحسزیتای ظیط هیثاقس:

o یکس : فرهت پیاهه یکس یا غیطی ASCIIتطای گساضی ط یک اظ کاضاتط ای اؾتاساضز . ی

کلی کاضاکتطایی ک اظ عطیق نفح $ & + کاضاکتطای التیي اػساز ػالئن اؾتاساضز هاس )

ضز یاظ اؾت (کلیس قازض ت تایپ کطزى آا هیثاقیس زض حالیک تطای گساضی ط . تا یک تایت ه

یکس قاهل کاضاکتط ای هطتط ت ظتاى ؾایط کكض ای زیا کاضاکتط ای )یک اظ کاضاکتط ای ی

یکس اظ قثیل ضز یاظ هی تاقس ( غیطΏ ®ی ضز اؾتفاز زض .ز تایت ه تاتطایي ع کاضاکتطای ه

اس . تاثیط گصاض هیثاقس (تؼساز کاضاکتطای هجاظ زض ط پیاهک)پیاهک تط عل پیاهک ط پیام وی ت

تیتی چى 16کاضاکتط 70 تیتی یا 7 کاضاکتط 160 تایت یا 140تیت تاقس یؼی 1120تیف اظ

( UTF-16 / UCS-2 ) تیتی16کاضاکتطای اپی هلعم ت اؾتفاز اظغظتاى ائی هاس فاضؾی ، چیی یا

این تیف اظ ،ؿتس . فاضؾی زاقت تاقینپیاهکای حطف زض70 وی ت

o زض نضتی ک عل پیاهک اظ حس هجاظ تجاظ وز، ػولیاتی ت ػاى تركثسی : تخطثذی پیاهه

الظم ت شکط اؾت ک زض . اضؾال هیگطزز (پاضت)ضی آى اجام هیكز پیاهک زض قالة چس ترف

3نضت تركثسی یک پیاهک فاضؾی اظ تؼساز کاضاکتطای هجاظ آى تطای ط ترف ت اساظ

کاضاکتط ال 67 کاضاکتطی، 80ت ػاى هثال تطای اضؾال یک پیاهک فاضؾی . کاضاکتط کؿط هیگطزز

تطای پیاهکای اگلیؿی، ت اظای . زض پاضت ال پیاهک تقی کاضاکتطا زض پاضت زم آى شکط هیكس

الثت تایس ذاعطكاى ؾاذت ک و هتي زض قالة یک پیاهک ت . کاضاکتط کؿط هیگطزز7ط ترف،

.گیطس هیطؾس

2

o پاضت هیثاقس ایي تؼساز تطای پیاهکای فاضؾی 8عل پیاهک حساکثط : عل پیاهه تر حسة پارت

. اگلیؿی یکؿاى اؾت

o ک تاقس (غیط اظ اگلیؿی)ظتاى هتي پیاهک ت ط ظتای : تاثیر زتاى هتي پیاهه تر تؼییي فرهت آى

یکس هحاؾث هیكز یکس) تایتی 2 جز فقظ یک کاضکتط . تهضت ی یکس (ی زض کل هتي، تطای ی

تزى کل پیام کفایت هی کس ت ػاى هثال شکط تا یک حطف فاضؾی زض یک پیاهک اگلیؿی تاػث

ضز ایي پیاهک لحاػ قس یکس زض ه .هیكز ک کلی هحسزیتای پیاهکای ی

o یؼی تطای پیاهکای اگلیؿی . ایي هقساض چاض تطاتط عل اؾتاساضز پیام هیثاقس : حذاوثر عل پیاهه

. کاضاکتط هیثاقس536 کاضاکتط تطای پیاهکای فاضؾی حساکثط 1224حساکثط

Businesscard : کاضت یعیت یا کاضت تثلیغاتی یک پیاهک ذال اؾت ک هاس یک کاضت یعیت هؼولی

چیي پیاهکی تهضت هؿتقین ضی وایكگط تلفي . حای اعالػاتی اظ قثیل ام فطؾتس قواض تلفي ا هیثاقس

وطا قرم گیطس فطؾتاز قس لی تهضت ذزکاض زض تلفي وطا یا ؾین کاضت قرم گیطس شذیط

اس زض نضت توایل آى ضا زض حافظ ؾین کاضت یا تلفي وطا ذز وی قز، تا ایي حال گیطس پیام هی ت

. شذیط کس

Flash message : چیي پیاهکی تا . یع هؼطف اؾت"پیاهک فضی"ع ذانی اظ پیاهک هیثاقس ک تا ام

ق شذیط ویكز، تلک هؿتقیوا ضی وایكگط تلفي وطا ظاط هیكز Inboxضؾیسى ت گقی گیطس زض پ

اضز اؾتفاز اظ چیي پیاهکی . پؽ اظ ایک گیطس ط کلیسی ضا فكاض زاز، ذزترز پاک هیكز یکی اظ ه

ضع هن جلة کیس ج گیطس پیام ضا ت یک ه زض ػیي حال گیطس پیاهک . ظهای اؾت ک ترایس فضا ت

ق . شذیط کسInboxهیتاس تا ت زلرا ذز آى ضا زض پ

Wappush : پپـ پیاهکی اؾت ک هكاتMMS تز تا اؾتفاز اظ آى هیتایس یک پیس http ضا

چیي کاضی اظ عطیق پیاهکای هؼولی یع اهکاى پصیط اؾت اها ج توایع پپـ زض ایي جث . اضؾال کیس

(ت ػاى هثال فایل نتی یا تهیطی)اؾت ک گیطس پیام هیتاس تا اؾتفاز اظ ایي پیس ت هحتای آى

.زؾتطؾی پیسا کس

Short code قواض تلفی ک اظ ؾی قطکت ػهط فطا اضتثاط ت هكتطکیي ایي : "ضوار اختصاصی" یا

الظم ت شکط اؾت ک . 30001234567891 آغاظ هیگطزز هاس 3000ایي قواض تا ػسز . قطکت اضائ هیكز

ضقوی یا 10ضقوی، 14اهکاى اضائ قواضای . آغاظ ویكس30000قواضای اضائ قس یچگا تا پیككواض

. ضقوی ت افطاز هایل ت اؾتفاز اظ تؿطیؿای قطکت ػهط فطا اضتثاط جز زاضز8

:زض ایي ترف ت ػثاضاتی هیپطزاظین ک زض تؿطیؿای اضائ قس اظ عطف قطکت ػهط فطا اضتثاط اؾتفاز هیكس

ضیح زازى ػثاضات ایي ترف ت ضس زضیافت تؿطیؿای اضائ قس اظ ؾی قطکت ػهط فطا اضتثاط هی -قثل اظ ت

:پطزاظین

3

پؽ اظ اضائ زضذاؾت فطز هثی تط ذطیس تؿطیؽ اضؾال زضیافت پیاهک، ایي تؿطیؿا ت وطا یک قواض

زض اذتیاض فطز قطاض زاز (password) یک کلو ػثض (username)اذتهانی چاضز ضقوی ضایگاى، یک ام کاضتطی

الظم ت شکط اؾت ک ط هكتطک هیتاس ت . هیكز تا تا اؾتفاز اظ آا اظ ذسهات قطکت ػهط فطا اضتثاط اؾتفاز کس

ؾایط قواضای )تؼساز زلرا قواض اذتهانی زاقت تاقس الیي قواض، عی ضقوی اظ هكتطک 14غیط اظ عی

ضقوی یع اؾتفاز کس ک 8 ضقوی یا 10ػال تط ایي، هكتطک زض نضت توایل هیتاس اظ قواضای . (زضیافت هیگطزز

ؾالیا قواض زضیافتی ضا تپطزاظز ػال تط آى زض نضت ازاه اؾتفاز اظ تؿطیؽ، عی زض ایي نضت تایس عی

.توسیس ایي قواض ضا یع پطزاذت وایس

Username :ام کاضتطی ک پؽ اظ زضیافت تؿطیؽ اضؾال زضیافت پیاهک ت فطز اضائ هیكز .

. هكتطک زض نضت توایل هیتاس اظ عطیق قطکت ػهط فطا اضتثاط ؿثت ت تغییط ام کاضتطی ذز اقسام کس

.تطای تؼییي ام کاضتطی هجاظ هیثاقس (... "&"، "."هاس )اؾتفاز اظ کلی اػساز، حطف ػالئن

Password : هكتطک .پؽ اظ زضیافت تؿطیؽ اضؾال زضیافت پیاهک ت فطز اضائ هیكزکلو ػثض ک

اؾتفاز اظ کلی اػساز، . هیتاس تا هطاجؼ ت ترف تظیوات زض اقتطاک ذز ؿثت ت تغییط ضهع اقسام وایس

.تطای تؼییي ام کاضتطی هجاظ هیثاقس (... "&"، "."هاس )حطف ػالئن

ID : یکی اظ انغالحاتی ک زض تؿطیؽ هطتط ت هسیطیت پیاهکای زضیافتی پطاؾتفاز اؾت زض و

ؾظ کاضتط اؾت ک زض ب ID. هتسای ایي تؿطیؽ کاضتطز زاضز زض اقغ واى قاؾ پیاهک اضؾال قس ت

ؾظ قطکت ػهط فطا اضتثاط ت نضت یک یػگی هحهطتفطز 5ؾطیؽ ؿر ت تؼس پؽ اظ اضؾال پیاهک ت

تطتیثی ضا auto incrementالظم ت شکط اؾت ک ایي قاؾ یػگی . ت اضؾال کس پیام اضائ هی گطزز

ؾیؿتن قواضگصاضی قاؾا . ساضز یؼی قواضای قاؾای یک هكتطک ت نضت پكت ؾط ن یؿتس

ت نضت نؼزی اکیس تز زض تیي و هكتطکیي، یکؿاى اؾت ت ػاى هثال هوکي اؾت یکی اظ هكتطکیي

. زض اذتیاض هكتطک زیگطی قطاض تگیطز51 زاقت تاقس لی قاؾ 50پیاهکی تا قاؾ

Mobile : تایل هراعثیي ک حساکثط تؼساز ػانط آى ح . هیثاقس89آضایای هتكکل اظ قواضای ه

.هیثاقس+ xxxxxxxxx09 xxxxxxxxx 989هقساضزی ت اػضای ایي آضای ت نضت

4

:وب سرویسهای ارائه شذه از سوی شرکت عصر فرا ارتثاط

(Box Service )4تؿطیؽ اضؾال پیاهک ؿر .1

(Web Service )1تؿطیؽ اضؾال پیاهک ؿر .2

(Box Service )5ب ؾطیؽ اضؾال پیاهک ؿر .3

(Box Service )7ب ؾطیؽ اضؾال پیاهک ؿر .4

(Inbox Service )1تؿطیؽ زضیافت پیاهک ؿر .5

(Box Service )4وب سرویس ارسال پیاهک نسخه

ای ارائ ضذ در ایي تسریس اهىاى ارسال ااع پیاهه را در اختیار فرد لرار هیذذ وچیي . هتذ

ا از عریك پرتىل ارتثاعی - ت ارسال درخاست دریافت پاسخ هیSOAPالزم ت رور است و ایي هتذ

ا ت ضرح ریل هیثاضذ. پردازذ :ایي هتذ

sendBusinessCard sendMessage sendWappush

:آدرس ایي ب سریس ت ضرح ریل هیثاضذ

http://www.afe.ir/WebService/V4/BoxService.asmx

ا هیپردازین :اوى ت هؼرفی تطریح ر یه از ایي هتذ

sendBusinessCardهتذ

اضؾال کاضت یعیت: کاضتطز

ضز یاظ تطای اضؾال زضذاؾت :لیؿت پاضاهتطای ه

اجثاری تضیحات ع پاراهتر ام پاراهتر

Username String جز زض ؾیؿتن ام کاضتطی هكتطک ه

Password String جز زض ؾیؿتن کلو ػثض هكتطک ه

Number String قواض اذتهانی هكتطک

Mobile Array of string تایل هراعثیي تطای ایک - آضایای اظ قواضای ه

زضذاؾتا تا کیفیت هغلتتطی تطای هراعثیي

اضؾال قز تطای ایي پاضاهتط زض ط تاض فطاذای


5

پیاهک ضا اػوال وزاین، تا 89هحسزیت تؼساز

تطای اضؾال . پیاهک ا تا ؾطػت تیكتطی اضؾال قس

تیكتط اظ ایي تؼساز هیتایس اظ حلقای تکطاض ت ح

.هاؾة اؾتفاز وائیس

ContactName String ام اضؾالکس پیاهک

PhoneNumber String قواض تواؼ اضؾالکس پیاهک

Type String ضیحات کاهل ضاجغ ت هقازیط ایي )ح اضؾال ت

(پاضاهتط زض جسل ظیط شکط قساس

Type تضیح

زض ایي گام پیاهک تهضت هؿتقین ت ضی نفحة تلفي وطا قرم گیطس فطؾتاز قس لی تهضت 0

اس ذزکاض زض تلفي وطا یا ؾین کاضت قرم گیطس شذیط وی قز، تا ایي حال گیطس پیاهک هی ت

ای ضا زض حافظ ؾین کاضت یا حافظ تلفي وطا ذز شذیط ContactName PhoneNumberپاراهتر

.کس

ای )پیاهک 1 زض حافظة تلفي وطا قرم گیطس شذیط (ContactName PhoneNumberپاراهتر

.هی قز

ای )پیاهک 2 زض حافظة ؾین کاضت قرم گیطس شذیط هی (ContactName PhoneNumberپاراهتر

.قز

ذال تطای شذیط پیاهک (طم افعاض) Applicationزض نضتیک تلفي وطا قرم گیطس پیاهک زاضای یک 3

ای )ذال تاقس، پیاهک زضیافتی (طم افعاض) Applicationیا اظ عطیق ضایا زاضای یک پاراهتر

ContactName PhoneNumber) زض آى شذیط هی کس.

: خرجی هتذ

ت ایي . ایي ذطجی ت نضت آضایای اظ ضقتا تز تطای هكرم وزى ضؼیت پیام ای اضؾالی ت کاض هیطز

ت . وایف زاز هیكز"send successfully"نضت ک تطای ط قواضای ک پیاهک ضا زضیافت کطز اؾت، ضقت

ػثاضتی اتظاض هیطز ک تیج ذطجی آضای ت تؼساز اػضای ضزی تاقس زض حالیک تیج ذطجی یک آضای یک

.ػضی تاقس، آى یک ػهط جاب توام اػضای ضزی تز وایاگط ذغای ت جز آهس زض ظهاى اضؾال اؾت

ای احتوالی : لیست خغا

ت نضت اقتثا ت هتس پاؼ زاز قز، پیغام ذغای password یا پاضاهتط usernameزض نضتیک پاضاهتط .1

username or password wrongوایف زاز هیكز .

6

یچ هقساضی ؿثت زاز كز، پیغام ذغای password یا پاضاهتط usernameزض نضتیک ت پاضاهتط .2

Username or Password is Nullوایف زاز هیكز .

وایف wrong number ت نضت اقتثا ت هتس پاؼ زاز قز پیغام ذغای Numberزض نضتیک پاضاهتط .3

.زاز هیكز

virtual یچ هقساضی ؿثت زاز كز یا هؼتثط ثاقس، پیغام ذغای Numberزض نضتیک ت پاضاهتط .4

number is invalid or emptyوایف زاز هیكز .

mobile array isزاز قز، پیغام ذغای ت نضت آضای ذالی ت ایي هتس پاؼ Mobileزض نضتیک پاضاهتط .5

emptyوایف زاز هیكز .

وایف زاز mobile array is null، پیغام ذغای ت ایي هتس پاؼ زاز كزMobileآضای زض نضتیک .6

.هیكز

More Than 89 Mobile Numbers تاقس، پیغام 89 تیف اظ Mobileزض نضتیک تؼساز اػضای آضای .7

.وایف زاز هیكز

ت ایي هفم ک . وایف زاز هیكز"no credit"زض نضتیک قاضغ هكتطک تطای اضؾال کافی ثاقس، پیغام .8

حتی اگط هیعاى قاضغ تاقیواس تطای اضؾال تؼسازی اظ پیاهکای هكتطک کفایت کس، یچ یک اظ آا زض ایي

.حالت اضؾال راس قس

هطتط ت هكتطک اظ ؾی قطکت ػهط فطا اضتثاط غیطفؼال گطزز، (username)زض نضتیک ام کاضتطی .9

ذاس قس"user not enable"اؾتفاز اظ هتسای تؿطیؿا هجط ت وایف ذغای

تجاظ کس، (زض ترف هفاین انغالحات پای هكرم قس اؾت)زض نضتیک عل پیام اضؾالی اظ حس هجاظ .10

. وایف زاز هیكزMessage is too Longپیغام

. وایف زاز هیكز"Unrecognized Message Body "زض نضتیک هتي پیاهک اقاذت تاقس، پیغام .11

Special Number With "زض نضتیک قواض اذتهانی اضائ قس تا ام کاضتطی هغاتقت ساقت تاقس، پیغام .12

the Username does not match"وایف زاز هیكز .

تایل اهؼتثط تاقس یا هالک قواض زضیافت پیاهک تثلیغاتی ضا تطای ذز غیطفؼال کطز .13 زض نضتیک قواض ه

. وایف زاز هی قز"Mobile number is invalid or empty"تاقس، پیغام

قاضغ اظ کاضتط کن هیكز ک تیج اضؾال : 1ىت هن تاقس، حتی اگط ایي Send Successfullyفقظ ظهای عی

آى کؿط ویكز .پیاهک ا ت هراتطات اضؾال كس عی

.ح هحاؾث کاضت یعیت هاس پیاهک اگلیؿی هیثاقس: 2 ىت هن

7

sendMessageهتذ

اضؾال پیاهک: کاضتطز




Password String جز زض ؾیؿتن کلو ػثض هكتطک هNumber String قواض اذتهانی هكتطک Mobile Array of string تایل هراعثیي تطای ایک - آضایای اظ قواضای ه




تطای اضؾال . پیاهکا تا ؾطػت تیكتطی اضؾال قس



Message String هتي پیاهک اضؾالی



Type تضیح


اس پاضاهتط ذزکاض زض تلفي وطا یا ؾین کاضت قرم گیطس شذیط وی قز، تا ایي حال گیطس پیاهک هی ت

Messageضا زض حافظ ؾین کاضت یا حافظ تلفي وطا ذز شذیط کس .

.زض حافظة تلفي وطا قرم گیطس شذیط هی قز (Messageپاراهتر )پیاهک 1

.زض حافظة ؾین کاضت قرم گیطس شذیط هی قز (Messageپاراهتر )پیاهک 2


زض (Messageپاراهتر )ذال تاقس، پیاهک زضیافتی (طم افعاض) Applicationیا اظ عطیق ضایا زاضای یک

.آى شذیط هی کس

:خرجی هتذ

ت ایي . ایي ذطجی ت نضت آضایای اظ ضقتا تز تطای هكرم وزى ضؼیت پیام ای اضؾالی ت کاض هیطز

ت . وایف زاز هیكز"send successfully"نضت ک تطای ط قواضای ک پیاهک ضا زضیافت کطز اؾت، ضقت

8

ػثاضتی اتظاض هیطز ک تیج ذطجی آضای ت تؼساز اػضای ضزی تاقس زض حالیک تیج ذطجی یک آضای یک

.ػضی تاقس، آى یک ػهط جاب توام اػضای ضزی تز وایاگط ذغای ت جز آهس زض ظهاى اضؾال اؾت

ای احتوالی :لیست خغا





wrong number ت نضت اقتثا ت هتس پاؼ زاز قز پیغام ذغای Numberزض نضتیک پاضاهتط .3


virtual یچ هقساضی ؿثت زاز كز یا اهؼتثط تاقس، پیغام ذغای Numberزض نضتیک ت پاضاهتط .4

number is emptyوایف زاز هیكز .

mobile arrayزاز قز، پیغام ذغای ت نضت آضای ذالی ت ایي هتس پاؼ Mobileزض نضتیک پاضاهتط .5

is emptyوایف زاز هیكز .


.هیكز







. ذاس قس"user not enable"اؾتفاز اظ هتسای تؿطیؿا هجط ت وایف ذغای




9

Special Number "زض نضتیک قواض اذتهانی اضائ قس تا ام کاضتطی هغاتقت ساقت تاقس، پیغام .12

With the Username does not match"وایف زاز هیكز .



قاضغ اظ کاضتط کن هیكز ک تیج اضؾال : کت هن تاقس، حتی اگط ایي پیاهک Send Successfullyفقظ ظهای عی

آى کؿط ویكز .ا ت هراتطات اضؾال كس عی

sendWappushهتذ

ارسال یه لیه ب: وارترد

ای هردیاز ترای ارسال درخاست :پاراهتر




زضذاؾت ا تا کیفیت هغلب تطی تطای هراعثیي


پیاهک ضا اػوال وز این، تا 89هحسزیت تؼساز

تطای اضؾال . پیاهک ا تا ؾطػت تیكتطی اضؾال قس



Url String ضزظط www.afe.ir:ت ػاى هثال)آزضؼ ایتطتی ه

)

Description String ضزظط تطای آزضؼ ایتطتی : ت ػاى هثال)ػاى ه

(قطکت ػهط فطا اضتثاط



10

Type تضیح



URL descriptionضا زض حافظ ؾین کاضت یا حافظ تلفي وطا ذز شذیط کس .

.زض حافظة تلفي وطا قرم گیطس شذیط هی قز (URL descriptionپاراهتر )پیاهک 1

.زض حافظة ؾین کاضت قرم گیطس شذیط هی قز (URL descriptionپاراهتر )پیاهک 2


URLپاراهتر )ذال تاقس، پیاهک زضیافتی (طم افعاض) Applicationیا اظ عطیق ضایا زاضای یک

description) زض آى شذیط هی کس.

:خرجی هتذ

فقیت . زض قالة آضایای اظ ضقت تز تطای هكرم وزى ضؼیت لیک ب ت کاض هی ضز زض نضتیک اضؾال تا ه

. وایف زاز هیكز"send successfully"اجام قز، پیام









number is invalid or emptyوایف زاز هیكز .




.هیكز



11















قاضغ اظ کاضتط کن هیكز ک تیج اضؾال : 1ىت هن تاقس، حتی اگط ایي Send Successfullyفقظ ظهای عی

آى کؿط ویكز .پیاهک ا ت هراتطات اضؾال كس عی

پپـ هاس پیاهک اگلیؿی هیثاقس: 2ىت هن .ح هحاؾث عی

(web service )1وب سرویس ارسال پیاهک نسخه

ای ارائ ضذ در ایي ب سریس هیتاذ ػال تر ارسال هطترن ضروت ػصر فرا ارتثاط تا استفاد از هتذ

.پیاهه، از هیساى ضارش تالیواذ خد یس هغلغ ضد

ای ارائ ضذ در ایي تسریس ػثارتذ از :هتذ

GetRemainingCredit sendMessage

:آدرس ایي ب سریس ت ضرح ریل هی تاضذ

http://www.afe.ir/WebService/webservice.asmx

http://www.afe.ir/WebService/webservice.asmx

12

ا هیپردازین . در هغالة ریل ت تطریح دلیك ر یه از ایي هتذ

GetRemainingCreditهتذ

وایص هیساى ضارش تالیواذ هطترن : وارترد

ای هردیاز ترای ارسال درخاست پاراهتر




:خرجی هتذ

ت ایي نضت ک اگط قاضغ . ضقتای حای یک ػسز نحیح اؾت هیعاى قاضغ تاقیواس هكتطک ضا كاى هیسس

، اگط هكتطک ت قطکت ػهط فطا اضتثاط تسکاض تاقس، یک ػسز هفی اگط "نفط"هقساض : هكتطک ت اتا ضؾیس تاقس

. تؿتاکاض تاقس، یک ػسز هثثت ضا وایف هیسس






ضز اؾتفاز قطاض : 1کت اگط هكتطکی زاضای چس قواض اذتهانی تاقس، قاضغ اضیعی اظ ؾی ا تطای و ایي قواضا ه

تاتطایي هقساض وایكساز قس ت ػاى ذطجی ایي هتس، ت قواض ذانی اتؿت یؿت هجوع اػتثاض ضیالی . هیگیطز

.هكتطک ضا وایف هیسس

SendMessageهتذ

ارسال پیاهه: وارترد



13


Password String جز زض ؾیؿتن کلو ػثض هكتطک هNumber String قواض اذتهانی هكتطک

Mobile Array of string تایل هراعثیي تطای ایک - آضایای اظ قواضای ه







Message String هتي پیاهک اضؾالی

Type String ح اضؾال

Type تضیح









:خرجی هتذ

ت ایي تطتیة ک تطای . ت نضت آضایای اظ ضقتا تز تطای هكرم وزى ضؼیت پیام ای اضؾالی ت کاض هیطز

فقیت اضؾال هیكس، پیام فقیتآهیع "send successfully"کلی پیاهکایی ک تا ه تطای ط یک اظ ایي اضؾالای ه





14




.زاز هیكز

virtual number is empty یچ هقساضی ؿثت زاز كز، پیغام ذغای Numberزض نضتیک ت پاضاهتط .4





.هیكز















15

(Box Service )5وب سرویس ارسال پیاهک نسخه

ای هجد در ایي ب سریس ترای ارسال پیاهه استفاد هطترن ضروت ػصر فرا ارتثاط هیتاذ از هتذ

آدرس . ورد وچیي از هسایای ایي ب سریس هیتاى ت اهىاى تررسی ضؼیت پیاهه ارسالی اضار ورد

:ایي ب ت ضرح زیر است


ای ارائ ضذ در ایي ب سریس ػثارتذ از : هتذ

SendMessage GetMessageStatus GetMessagesStatus

ا هیپردازین .و در هغالة ریل ت تطریح دلیك ر یه از ایي هتذ

SendMessageهتذ

. اضؾال کطزbussinescard wappushالظم ت شکط اؾت ک ویتاى تا اؾتفاز اظ ایي هتس . اضؾال پیاهک: وارترد

ضزیاظ تطای اضؾال زضذاؾت ػثاضت اؾت اظ :لیؿت پاضاهتطای ه










Message String هتي پیاهک


Type تضیح


16









:خرجی هتذ

تطای . ت نضت آضایای اظ ضقتا تز ت اظای ط یک اظ پیاهکای اضؾال قس یک قاؾ پیاهک تطگطزاس هیكز

ضزظط ضزظط)اعالع اظ ضؼیت پیاهک هیتایس قاؾ پیاهک ه ضا ت ػاى پاضاهتط ضزی هتس (قاؾ پیاهکای ه

GetMessageStatus( GetMessagesStatus) ضز اؾتفاز قطاض زیس .ه

ای احتوالی لیست خغا






.زاز هیكز

virtual number is empty یچ هقساضی ؿثت زاز كز، پیغام ذغای Numberزض نضتیک ت پاضاهتط .4





.هیكز



17













GetMessageStatusهتذ

ج ت قاؾ اضائ قس: وارترد هكرم کطزى ضؼیت پیاهک اضؾالی تا ت




Password String جز زض ؾیؿتن کلو ػثض هكتطک هSmsID String قاؾ پیاهک

:خرجی هتذ

.ذطجی ایي هتس یک ضقت اؾت ک هقازیط احتوالی آى زض جسل ضؼیت پیاهک اضؾالی شکط قساس


.وایف زاز هیكز "Service is disabled"زضنضتی ک ؾطیؽ غیط فؼال تاقس، پیغام ذغای .1

Username is null or" ذالی ت هتس پاؼ زاز قز، پیغام ذغای usernameزض نضتیک پاضاهتط .2

empty"وایف زاز هیكز .

18

Password is null or" ذالی ت هتس پاؼ زاز قز، پیغام ذغای passwordزض نضتیک پاضاهتط .3


.وایف زاز هیكز "User Not Enable"زض نضتیک کاضتط غیط فؼال تاقس، پیغام ذغای .4


username or password wrong"" وایف زاز هیكز.

-وایف زاز هی "Wrong messageSentID"زض نضتیک کس پیاهک ذالی یا اقتثا تاقس، پیغام ذغای .6

.قز

GetMessagesStatusهتذ

ج ت قاؾای اضائ قس: کاضتطز هكرم کطزى ضؼیت پیاهکای اضؾالی تا ت





SmsID تطای ایي پاضاهتط زض –آضای ای اظ قاؾای پیاهک آضایای اظ ضقت ا

قاؾ پیاهک ضا 10ط تاض فطاذای هحسزیت تؼساز

تطای تطضؾی ضؼیت تیكتط اظ ایي . اػوال وزاین

تؼساز هیتایس اظ حلقای تکطاض ت ح هاؾة

.اؾتفاز وائیس

: خرجی هتذ

ج ت قاؾ اضائ قس ذطجی ایي هتس ت نضت آضایای اظ ضقت ا تز ضؼیت ط یک اظ پیاهکای زلرا تا ت

.هقساض احتوالی ط یک اظ اػضای ایي آضای زض جسل ضؼیت پیاهک اضؾالی شکط قس اؾت. تطای آى تطگطزاس هیكز


.وایف زاز هیكز "Service is disabled"زضنضتی ک ؾطیؽ غیط فؼال تاقس، پیغام ذغای .1

Username is null or" ذالی ت هتس پاؼ زاز قز، پیغام ذغای usernameزض نضتیک پاضاهتط .2


Password is null or" ذالی ت هتس پاؼ زاز قز، پیغام ذغای passwordزض نضتیک پاضاهتط .3


19

.وایف زاز هیكز User Not Enable""زض نضتیک کاضتط غیط فؼال تاقس، پیغام ذغای .4


"username or password wrong" وایف زاز هیكز.

وایف "messageSentID Array is NULL"زض نضتیک عل آضای کس پیاهک ا ذالی تاقس، پیغام ذغای .6

.زاز هیكز

More Than 10"خطای ذا تاقس، پیغام 10زض نضتیک عل آضای کس پیاهک ا تیكتط اظ .7

messageSentID" وایف زاز هیكز.

جذل ضؼیت پیاهه ارسالی

تضیحات ػاىIndeterminate ضؼیت پیاهک اهكرم اؾت SentToMobile پیاهک ت گقی هراعة ضؾیس اؾت

FailedToMobile پیاهک ت گقی هراعة طؾیس اؾت SentToComunicationCenter پیاهک ت هطکع هراتطاتی ضؾیس اؾت

FailedToComunicationCenter پیاهک ظ ت هطکع هراتطاتی طؾیس اؾت Pending پیاهک ت هطکع هراتطاتی ضؾیس اؾت اها ضؼیت آى ظ اهكرم

.اؾت

(BoxService )7وب سرویس ارسال پیاهک نسخه

آدرس


هتذها

جز زض ایي ب ؾطیؽ ت وطا ذالن ای اظ ػولکطز آا زض جسل ظیط شکط قس اس وچیي . لیؿت هتسای ه

.ػولکطز ط یک اظ آا ت نضت هكطح زض ازاه ضاوا تیاى قس اؾت

ػولىرد ػاى هتذ

GetMessageID ضؾیسى یا طؾیسى پیاهک ت ؾطض قطکت ػهط فطا اضتثاط

.ضا تطضؾی هیکس

GetMessageStatus ضؼیت پیاهک اضؾال قس ضا تطهی گطزاس.


20

GetMessagesStatus ضؼیت پیاهکای اضؾال قس ضا تطهی گطزاس.

GetRemainingCredit تاقیواس اػتثاض کاضتط ضا وایف هیسس.

SendMessage پیاهک ضا اضؾال هیکس.

SendMessagePeerToPeer ضا فطان هی آضز"ظیط ت ظیط"اهکاى اضؾال .

SendMessageهتذ

. اضؾال کطزbussinescard wappushالظم ت شکط اؾت ک ویتاى تا اؾتفاز اظ ایي هتس . اضؾال پیاهک: کاضتطز




Password String جز زض ؾیؿتن کلو ػثض هكتطک هNumber String قواض اذتهانی هكتطک

Mobile Array of string

تایل هراعثیي تطای ایک - آضایای اظ قواضای ه




تطای . پیاهکا تا ؾطػت تیكتطی اضؾال قس

اضؾال تیكتط اظ ایي تؼساز هیتایس اظ حلقای

.تکطاض ت ح هاؾة اؾتفاز وائیس

Message String هتي پیاهک


CheckingMessageID Array of Long

تؼساز اػضای . آضای حای کسای ضگیطی پیاهک

- هیMobileایي آضای تطاتط تؼساز اػضای آضای

اضؾال کس پیاهک تطای جلگیطی اظ اضؾال . تاقس

تکطاضی پیاهکا، تایؿتی ت اظای ط پیاهک، یک کس

ضگیطی زض ایي آضای زضج کس تا پؽ اظ اضؾال

پیاهکا تتاس تا اؾتفاز اظ ایي کس، ضؾیسى یا

طؾیسى ط یک اظ آا ت ؾطض قطکت ػهط فطا

ج زاقت تاقیس ک ط کس . اضتثاط ضا تطضؾی کس ت

ح ). ضظ هؼتثط ذاس تز10ضگیطی حساکثط تا

21

(اجام ایي کاض زض ازاه ضاوا قطح زاز ذاس قس

Type تضیح




.زض حافظة تلفي وطا قرم گیطس شذیط هی قز (Messageپاضاهتط )پیاهک 1

:خرجی هتذ

ؾظ ؾطض ػهط فطا اضتثاط .آضایای اظ قاؾ پیاهکای زضیافت قس ت

لیست خغاای احتوالی

: هوکي اؾت ذغاایی زضیافت کیس ک ت قطح ظیط هیثاقسsendMessageگام کاض تا هتس

ضرح پیغام خغا

username or password wrong پاضاهتطusername یا passwordاقتثا اؾت .

Username or Password is Null ت پاضاهتطusername یا password یچ هقساضی

.ؿثت زاز كس اؾت

wrong number پاضاهتطNumber ت نضت اقتثا ت هتس پاؼ زاز قس

.اؾت

virtual number is empty ت پاضاهتطNumberیچ هقساضی ؿثت زاز كس اؾت .

mobile array is empty پاضاهتطMobile ت نضت آضای ذالی ت ایي هتس پاؼ

.زاز قس اؾت

mobile array is null پاضاهتطMobileت هتس پاؼ زاز كس اؾت .

More Than 89 Mobile Numbers تؼساز اػضای آضایMobile اؾت89 تیف اظ .

no credit ج زاقت تاقیس . قاضغ هكتطک تطای اضؾال، کافی یؿت ت

ک حتی اگط هجوع تاقیواس اػتثاض هكتطک تطای اضؾال

پیاهک اظ ج ت ایک عی پیاهکا کافی تاقس، تا ت

جز کؿط هیكز، زض ایي حالت اضؾال تیكتطیي قاضغ ه

.اجام راس قس

user not enable ام کاضتطی(username) هطتط ت هكتطک اظ ؾی

22

.قطکت ػهط فطا اضتثاط غیطفؼال گطزیس اؾت

Message is too Long عل پیاهک اضؾالی اظ حس هجاظ، تیكتط اؾت.

CheckingMessageID Array Is Not Correct Format

آضایی حای کسای ضگیطی، ذالی هی تاقس یا ایک

تطاتط Mobileتؼساز اػضای آى تا تؼساز اػضای آضای

.یؿت

Mobile Number is invalid or empty ایي ذغا زض چسیي حالت هرالف ضخ هی زس:

تایل اهؼتثط اؾت.1 .قواض ه

تایل زضیافت پیاهک تثلیغاتی ضا تطای ذز .2 هالک ه

.غیطفؼال کطز اؾت

ایس نفط اتتسای قواض ضا حصف کطز زض ایي حالت هی ت

جایگعیي کیس زض نضتیک هجسزا 98یا + 98آى ضا تا

ویي پیغام ذغا ضا زضیافت کطزیس، هالک قواض قغؼا

زضیافت پیاهک تثلیغاتی ضا تطای ذز غیطفؼال وز اؾت

اج هی گطزز .لصا اضؾال پیاهک تا ذغا اظ ؾوت اپطاتض ه

GetMessageIDهتذ

:وارترد

ػسم اضؾال پیاهک ت ؾطض ػهط فطا اضتثاط/تطضؾی اضؾال

ضزیاظ تطای ضگیطی پیاهک ػثاضت اؾت اظ :لیؿت پاضاهتطای ه



Password String جز زض ؾیؿتن کلو ػثض هكتطک هCheckingMessageID Long کسی ک زض ظهاى اضؾال . کس ضگیطی پیاهک

پیاهک ت اظای ط پیاهک ت ب ؾطیؿای

.قطکت ػهط فطا اضتثاط اضؾال هیكز

:خرجی هتذ

هی تاقس ت ػاى ذطجی Stringزضنضتی ک ایي کس ضگیطی تطای قوا ثثت قس تاقس، کس پیاهک ک اظ ع

زضنضتی ک کس ضگیطی ثثت كس تاقس پیغام. تطگطزاس هیكز

23

Wrong CheckingMessageID""ت ػاى ذطجی تطگطزاس هی قز .

GetMessageStatusهتذ

پیگیطی ضؼیت پیاهک اضؾال قس: کاضتطز



Password String جز زض ؾیؿتن کلو ػثض هكتطک هSmsID String تا اضؾال ایي کس هیتایس ضؼیت . کس پیاهک

ضزظط ذز ضا تطضؾی کیس .پیاهک ه

:خرجی هتذ

.ذطجی ایي هتس یک ضقت اؾت ک هقازیط احتوالی آى زض جسل ضؼیت پیاهک شکط قساس

GetMessagesStatusهتذ

اؾت تا ایي تفات ک تا اؾتفاز اظ آى هیتایس تا ط تاض GetMessageStatusایي هتس زقیقا هكات هتس : وارترد

. پیاهک ضا تطضؾی کیس89فطاذای هتس، ضؼیت حساکثط



Password String جز زض ؾیؿتن کلو ػثض هكتطک هSmsID Array of

String

تا اضؾال ایي آضای هیتایس . آضایی اظ کس پیاهکا

ضزظط ذز ضا تطضؾی کیس . ضؼیت پیاهکای ه

ج زاقت تاقیس ک زض ط تاض فطاذای ایي هتس ت

پیاهک ضا تطضؾی 89هیتایس ضؼیت حساکثط

.کیس

:خرجی

24

ایي هتس آضایای اظ ضقتا ضا تطهیگطزاس ک ط ػض ایي آضای هتاظط تا ضؼیت پیاهکی اؾت ک کس آى زض آضای

SMSIDت ایي هتس اضؾال قس اؾت .

ضؼیت پیاهىایی و ارسال آا از سوت اپراتر اجام گرفت است سی ارسال آا از وارتر

. وسر ضذ است

تضیحات ػاى

Indeterminate ضؼیت پیاهک اهكرم اؾت

SentToMobile پیاهک ت گقی هراعة ضؾیس اؾت

FailedToMobile پیاهک ت گقی هراعة طؾیس اؾت

SentToComunicationCenter پیاهک ت هطکع هراتطاتی ضؾیس اؾت

FailedToComunicationCenter پیاهک ظ ت هطکع هراتطاتی طؾیس اؾت

Pending پیاهک ت هطکع هراتطاتی ضؾیس اؾت اها ضؼیت آى ظ اهكرم

.اؾت

ضؼیت پیاهىایی و ارسال آا از سرر ػصر فرا ارتثاط اجام ضذ اها ت یىی از دالیل زیر، تسظ

اپراتر هخاتراتی ترگطت خرداذ ت ویي دلیل سی آا از سوت ضروت ػصر فرا ارتثاط ت

ضذ است .وارتر ػدت داد

تضیحات ػاى

MobileNumberIsInvalidOrEmpty تایل قواض . تز اؾتذالی یا اهؼتثط ه

VirtualNumberIsInvalidOrEmpty تز اؾت ذالی یا اهؼتثط اذتهانی قواض.

MessageEncodingIsInvalid گ . تز اؾتاهؼتثط پیاهک، هتي اکسی

MessageClassIsInvalid اهؼتثط پاضاهتط

MessageUDHIsInvalid UDH ،تز اؾتاهؼتثط پیاهک .

MessageBodyAndUDHIsInvalid ى پیاهکهت UDH ؿتساهؼتثطآى ط ز .

MobileArrayIsEmpty تایل حای قواضآضای . گیطسگاى، ذالی اؾته

VirtualNumberArrayIsEmpty ایي پیغام ). اؾتاهؼتثط ،اذتهانی ایقواض حایآضای

ضز اضؾالای ظیط ت ظیطی وایف زاز هیكز ک زض ه

زض آا، پاضاهتط هطتط ت قواضای اذتهانی، هقساضزی

(. كس تاقس

25

GetRemainingCreditهتذ

وایف هیعاى قاضغ تاقیواس هكتطک : وارترد

ضزیاظ تطای اضؾال زضذاؾت ػثاضتس اظ :پاضاهتطای ه


Username String ام کاضتطی هكتطک

Password String کلو ػثض هكتطک

:خرجی

ت ایي نضت ک اگط قاضغ . ضقتای ک حای یک ػسز نحیح اؾت هیعاى قاضغ تاقیواس هكتطک ضا كاى هیسس

، اگط هكتطک ت قطکت ػهط فطا اضتثاط تسکاض تاقس، یک ػسز هفی اگط "نفط"هقساض : هكتطک ت اتا ضؾیس تاقس

.تؿتاکاض تاقس، یک ػسز هثثت ضا وایف هیسس

SendMessagePeerToPeerهتذ

پیاهک X قواض اذتهانی، Xتا اؾتفاز اظ ایي هتس هیتایس اظ تؼساز . اضؾال پیاهک ت نضت ظیط ت ظیط: وارترد

تایل اضؾال کیس Xهرتلف ضا ت ج زاقت تاقیس ک زض ط زضذاؾت، حساکثط . قواض ه اى اضؾال 89ت پیاهک هی ت

کطز




Password String جز زض ؾیؿتن کلو ػثض هكتطک هNumber Array of

string آضایای اظ قواضای اذتهانی

Mobile Array of string

تایل هراعثیي تطای ایک - آضایای اظ قواضای ه




تطای . پیاهکا تا ؾطػت تیكتطی اضؾال قس

اضؾال تیكتط اظ ایي تؼساز هیتایس اظ حلقای

.تکطاض ت ح هاؾة اؾتفاز وائیس

26

Message Array of string

ط یک اظ پیاهکای ایي . آضایای اظ هتای پیاهک

تایل هتاظط آى زض آضای آضای ت قواض ه

Mobileاضؾال ذاس قس .

Type Array of string

اػضای ایي آضای . آضایای اظ ح اضؾال پیاهک

ضع ؿتس ک ط یک اظ كاى زس ایي ه

.پیاهکا ت چ نضتی اضؾال ذاس قس

CheckingMessageID Array of Long

تؼساز اػضای . آضای حای کسای ضگیطی پیاهک

- هیMobileایي آضای تطاتط تؼساز اػضای آضای

اضؾال کس پیاهک تطای جلگیطی اظ اضؾال . تاقس

تکطاضی پیاهکا، تایؿتی ت اظای ط پیاهک، یک کس

ضگیطی زض ایي آضای زضج کس تا پؽ اظ اضؾال

پیاهکا تتاس تا اؾتفاز اظ ایي کس، ضؾیسى یا

طؾیسى ط یک اظ آا ت ؾطض قطکت ػهط فطا

ج زاقت تاقیس ک ط کس . اضتثاط ضا تطضؾی کس ت

ح ). ضظ هؼتثط ذاس تز10ضگیطی حساکثط تا

(اجام ایي کاض زض ازاه ضاوا قطح زاز ذاس قس

:خرجی

ؾظ ؾطض قطکت ػهط فطا اضتثاط اؾت .آضایای اظ ضقتا ک حای کس پیاهکای زضیافت قس ت

روال کلی کار تا هتذهای وب سرویس

.نضت هیگیطز (SendMessagePeerToPeerیا ) SendMessageاتتسا اضؾال پیاهک تا اؾتفاز اظ هتس

زض نضتیک ذطجی ایي هتس ت اظای ط یکی اظ پیاهکای اضؾال قس یک ضقت ػسزی تاقس، ت ایي هفم اؾت ک

. پیاهک ت ؾطض قطکت ػهط فطا اضتثاط ضؾیس اضؾال آى اجام ذاس قس

اج گطزیس، ت جای اضؾال timeout اگط کاضتط گام اضؾال پیاهک تا ذغای اظ عطف ؾطض قطکت ػهط فطا اضتثاط ه

تطای اجام ایي کاض تایؿتی کس ضگیطی . هجسز پیاهک هیتاس اظ ضؾیسى یا طؾیسى آى ت ؾطض، اعویاى حانل کس

ضزظط ت هتسای اضؾال پیاهک CheckingMessageIDکسی ک زض گام اضؾال پیاهک ت نضت آضای )پیاهک ه

، تظین کطز تا فطاذای ایي هتس، ضؼیت پیاهک GetMessageIDپاؼ زاز قس تز ضا ت ػاى پاضاهتط ضزی هتس

تاقس، پیاهک ت ؾطض "Wrong CheckingMessageID"زض نضتیک ذطجی ایي هتس، پیغام ذغای . ضا تطضؾی کس

27

اها زض نضتیک ذطجی آى یک ضقت ػسزی تاقس، پیاهک . ػهط فطا اضتثاط طؾیس کاضتط تایس هجسزا آى ضا اضؾال کس

ؾظ ؾطض ػهط فطا اضتثاط زضیافت قس ایي ػسز واى قاؾای اؾت ک زض ظهاى اضؾال پیاهک، کاضتط ت فقیت ت تا ه

. ، تاؿت آى ضا زضیافت کسTimeoutزلیل ضخ زازى ذغای

یا GetMessageStatusزض ایت ضؼیت پیاهک تا اؾتفاز اظ قاؾ آى تا فطاذای هتسای

GetMessagesStatusقاتل تاظیاتی اؾت .

Query Stringارسال پیاهک از طریق

تا استفاد از ایي رش هیتایذ تا ام وارتری ولو ػثری و ت ػاى هطترن ضروت ػصر فرا ارتثاط در اختیار

. ضوا لرار گرفت است تا استفاد از یه آدرس ایترتی ت ارسال پیاهه تپردازیذ

http://www.AFE.ir/Url/SendSMS.aspx: آدرس ایترتی ترای ارسال پیاهه

ای ضرری ترای استفاد از ایي رش ػثارتذ از :پاراهتر




Number String قواض اذتهانی هكتطک

Mobile String تایل هراعة قواض ه

SMS String هتي پیاهک

ولو "test2" تا ام وارتری "09124445566" ت ضوار هتایل "salam"ترای ارسال پیاهىی تا هتي : هثال

: تایذ از آدرس زیر استفاد ویذ"30007957002376" تا ضوار اختصاصی "1234"ػثر

http://www.AFE.ir/Url/SendSMS.aspx?Username=test&Password=1234&Number=30007957002376&Mobile=09124445566&SMS=salam

تایل ط تاض تایس ویي کاض ضا تطای ط یک اظ ایي قواض: ىت -الظم ت شکط اؾت ک تطای اضؾال پیاهک ت چس قواض ه

.ا تکطاض کیس

لیؿت ذغاای احتوالی

28








number is emptyوایف زاز هیكز .

mobile arrayزاز قز، پیغام ذغای ت نضت آضای ذالی ت ایي هتس پاؼ Mobileزض نضتیک پاضاهتط .5

is emptyوایف زاز هیكز .


.هیكز













:نکات ههن راجع ته وتسرویسهای ارسال پیاهک

کاضاکتطی التیي ت ػاى ام 11زض کلی هتسای اضؾال هیتاى ت جای شکط قواض اذتهانی اظ یک ضقت .1

(!الظم ت شکط اؾت ک ؾطیؽ ام تجاضی زض حال حاضط فؼال ویثاقس). تجاضی اؾتفاز وز

29

فقیت اجام قز، پیغام .2 send"زض کلی هتسای ایي تؿطیؿا زض نضتی ک اضؾال ت قواض هراعة تا ه

successfully" یا قاؾ پیاهک ت اظای آى قواض ت وایف زض ذاس آهس زض غیط ایهضت پیغام ذغای

.هاؾة وایف زاز هیكز

:زالیل طؾیسى پیاهک ت گقی هراعثیي ػثاضتس اظ .3

تاال تزى تطافیک قثک

اذتالل زض قثکBTS

اقکال زض ب ؾطیؽ هراتطاتی

زض زؾتطؼ ثزى گقی

تایلایی تطضؾی هیكز ک تا پیكس .4 ( xxxxxxxx091 )091گام اضؾال پیاهک فقظ فؼال تزى قواض ه

ت ػاى هثال اگط قواض . قطع هیكس زض غیط ایي نضت فؼال یا ػسم فؼال تزى قواض ا تطضؾی ویكز

تایلی تا ؾظ ػهط فطا اضتثاط تطضؾی وی گطزز+ 98ه . یا فطهت ای زیگط قطع قز، ضؼیت آى ت

تاک اعالػاتی هطتط ت قواض ای فؼال ت نضت ؾالیا ت ضظ هیكز، یؼی هوکي اؾت تؼضی قواض ا .5

قتی هكکل قواضایی ک . فؼال قس فؼال تزى آا تا تاذیط چس ها زض ؾیؿتن ثثت گطزز تطای ضفغ ه

ضا اضاف کطز تا اػتثاض آا تطای اضؾال پیاهک تطضؾی + 98تاظ فؼال قساس، هیتاى ت اتتسای آى قواضا

.كز

یا زضیافت قاؾ پیاهک تساى هؼی اؾت ک پیاهک اظ ؾطض قطکت ػهط فطا " send successfully"پیغام .6

زض نف (...اظ قثیل حجن تطافیکی، هكکالت فی یا )اضتثاط ت اپطاتض هراتطاتی تحیل زاز قس یا ت زالیلی

ت عض کلی اگط ایي پیغام . اضؾال قطکت ػهط فطا اضتثاط تز هتظط تحیل ت ؾطض اپطاتض هراتطاتی اؾت

. وایاى قز یؼی اػتثاض اظ هكتطی کاؾت قس پیام اضؾال قس یا تؼسا اضؾال ذاس قس

"Service is disabled "اگط هسیط ؾیؿتن، کل ؾطیؽ اضؾال زضیافت پیاهک ضا هتقف کطز تاقس، پیغام .7

.ت وایف زض هیآیس

+ 98 یا 98، نفط اتتسای قواض وطا ضا تا "Mobile number is invalid or empty"پؽ اظ زضیافت پیغام .8

اج قسیس پیاهک اضؾال گطزیس، . جایگعیي وز هجسزا اضؾال واییس زض نضتیک هجسزا تا ویي پیغام ه

هالک قواض زضیافت پیاهک تثلیغاتی ضا تطای ذز غیطفؼال وز اؾت ت ویي زلیل پؽ اظ اضؾال زضذاؾت

ؾظ ػهط فطا اضتثاط، اپطاتض اظ اضؾال پیاهک هواؼت ت ػول هی آضز اضزی هالک قواض تایس . ت زض چیي ه

.قرها جت فؼالؿاظی زضیافت پیاهک تثلیغاتی اقسام وایس

9. IP هی تاقس87.107.121.243 ؾطض اضؾال کس پیاهکا .

30

(Inbox Service )1وتسرویس دریافت پیاهک نسخه

ای ارائ ضذ در ایي تسریس ترای هذیریت پیاهىای هطترن ضروت ػصر فرا ارتثاط هیتاذ از هتذ

.دریافتی خد استفاد وذ

:آدرس ایي ب سریس ػثارت است از

http://www.afe.ir/WebService/Inboxservice.asmx

هطترن از جول Inbox ػولیاتی از لثیل دریافت اعالػات پیاهىا تررسی ولی جسئی پیاهىای هجد در

ای ایي تسریس ػثارتذ از . اهىاات ایي تسریس هیثاضذ :هتذ

Get : دریافت اعالػات یه پیام خاظ تا تج ت ضاس ارائ ضذ

GetFirst : هتذی ترای دریافت اعالػات الیي پیاهه هجد درInbox

GetLast : هتذی ترای دریافت اعالػات آخریي پیاهه هجد درInbox

GetNext : دریافت اعالػات پیاهه تؼذی تا تج ت ضاس ارائ ضذ

GetPerior : دریافت اعالػات پیاهه لثلی تا تج ت ضاس ارائ ضذ

List : ػذد100 تا 0دریافت اعالػات تؼذادی از پیاهىای دریافتی تیي

GetCount : وایص تؼذاد ول پیاهىای دریافتی

ای فق هیپردازین :اوى ت تطریح دلیك ر یه از هتذ

Getهتذ

(ضاس پیاهىی و اعالػات آى تایذ دریافت ضذ) IDدریافت اعالػات پیاهه تا تج ت پاراهتر : وارترد

ای هردیاز ترای ارسال درخاست ػثارتذ از :پاراهتر


Username string جز زض ؾیؿتن ام کاضتطی هكتطک ه

Password String جز زض ؾیؿتن کلو ػثض هكتطک هID int قاؾ پیاهک زضیافتی

:ضیای و حای اعالػات زیر هیثاضذ: خرجیای ایي هتذ ػثارتذ از

تضیحات ع ػاى

ID int قاؾ پیاهک زضیافتی

http://www.afe.ir/WebService/Inboxservice.asmx

31

From String تایل فطؾتس پیاهک قواض ه

To String جز زض ؾیؿتن قواض اذتهانی هكتطک ه

Date Datetime تاضید زضیافت پیاهک

Body String هتي پیام

CharCount Int تؼساز کاضاکتطای پیاهک زضیافتی

IsUnicode boolean یکس اؾت یا ذیط فطهت پیاهک زضیافتی ی






هتؼلق ت هكتطک تاقس، اعالػات هطتط ت پیاهک ت وایف زض هیآیس زض غیط idزض نضتیک پاضاهتط .3

. وایف زاز هیكزnullایهضت هقساض

GetFirstهتذ

نطفظط اظ ایک هكتطک چس قواض اذتهانی )ایي هتس اعالػات هطتط ت الیي پیاهک زضیافتی هكتطک ضا : کاضتطز

.كاى هیسس (زاقت تاقس یا ذیط





To string زض نضتیک ایي . قواض اذتهانی گیطس پیاهک

یا ضقت ذالی هقساضزی قز، ت ایي Nullپاضاهتط تا

هفم هیثاقس ک قواض اذتهانی هكرم كس

اؾت زض نضتیک هكتطک زاضای چس قواض

اذتهانی تاقس، هیتاس ت ایي عطیق اعالػات هطتط

ذز ضا هكاس Inboxت آذطیي پیاهک زضیافتی زض

. وایس

-

32















وایف زاز "wrong number" اقتثا تاقس، پیغام Toزض نضتیک قواض اذتهانی شکط قس زض پاضاهتط .3

.هیكز

GetLastهتذ

نطفظط اظ ایک هكتطک چس قواض اذتهانی )ایي هتس اعالػات هطتط ت آذطیي پیاهک زضیافتی هكتطک ضا : وارترد

.كاى هیسس (زاقت تاقس یا ذیط

ای هردیاز ترای ارسال درخاست ػثارتذ از : پاراهتر








-

33


ذز ضا هكاس Inboxت آذطیي پیاهک زضیافتی زض

.وایس

:ضیای و حای اعالػات زیر هیثاضذ: ای ایي هتذ ػثارت است از خرجی















.هیكز

GetNextهتذ

. هطترن ترهیگرداذ Inboxتا تج ت ضاس پیاهه ارسال ضذ ت ایي هتذ، اعالػات پیاهه تؼذی را از : وارترد



34


Password String جز زض ؾیؿتن کلو ػثض هكتطک هTo string زض نضتیک ایي . قواض اذتهانی گیطس پیاهک



.اؾت

-

ID Int قاؾ پیاهک زضیافتی









IsUnicode Boolean یکس اؾت یا ذیط فطهت پیاهک زضیافتی ی

ت ػاى null، پیاهىی جد ذاضت تاضذ، همذار IDدر صرتی و ت ازای همذار سثت داد ضذ ت پاراهتر

.خرجی ترگطت داد هیطد







.هیكز

35

GetPeriorهتذ

. هطترن ترهیگرداذ Inboxتا تج ت ضاس پیاهه ارسال ضذ ت ایي هتذ، اعالػات پیاهه لثلی را از : وارترد







.اؾت

-


:ضیای و حای اعالػات زیر هیثاضذ: خرجیای ایي هتذ ػثارت است از









ت ػاى null، پیاهىی جد ذاضت تاضذ، همذار IDدر صرتی و ت ازای همذار سثت داد ضذ ت پاراهتر

.خرجی ترگطت داد هیطد




36




.هیكز

Listهتذ

. پیاهک ت کاض هی ضز100 تا 0ایي هتس تطای زضیافت لیؿتی اظ اعالػات پیاهک ای زضیافتی ت تؼساز : وارترد




Password String جز زض ؾیؿتن کلو ػثض هكتطک هTo string زض نضتیک ایي . قواض اذتهانی گیطس پیاهک





. ذز ضا هكاس وایسInboxت پیاهکای زضیافتی زض

-

ID Int زض نضتیک هقساض ایي پاضاهتط –قاؾ پیاهک زضیافتی

100نفط یا یک ػسز هفی تاقس ت ایي هؼی اؾت ک

تطگطزاس قس، زض نضتیک inboxپیاهک اتتسای

ج ت هقساض ایي پاضاهتط یک ػسز هثثت تاقس، تا ت

، پیاهکا اظ ایي قاؾ ت تؼس تطگطزاس countپاضاهتط

.هیكس

Count Int ط ) 100 تا 0 ػسزی تیي –تؼساز پیاهکای زلرا

( زض ظط گطفت هیكز100هقساض زیگطی ت ػاى

:آرایای از پیاهىای دریافتی و ر ػض آى دارای چیي اعالػاتی هیثاضذ: خرجیای ایي هتذ ػثارتذ از





37




IsUnicode Boolean یکس اؾت یا ذیط فطهت پیاهک زضیافتی ی







.هیكز

Inboxتا استفاد از ایي هتذ تىار گیری حلمای تىرار هیتاى اعالػات ول پیاهىای هجد در : ىت

.را ت دست آرد

GetCountهتذ

. ایي هتس تطای زضیافت تؼساز پیاهک زضیافتی ت کاض هی ضز: وارترد

ضزیاظ تطای اضؾال زضذاؾت ػثاضتس اظ :پاضاهتطای ه




To String زض نضتیک ایي . قواض اذتهانی گیطس پیاهک





. ذز ضا هكاس وایسInboxت پیاهکای زضیافتی زض

-

ID Int زض نضتیک ایي پاضاهتط زاضای هقساض هفی یا نفط

جز زض تطگطزاس inboxتاقس، تؼساز کل پیاهکای ه

هیكز لی زض نضتیک ایي پاضاهتط حای یک ػسز

هثثت تاقس، تؼساز پیاهکایی ک تؼس اظ ایي قاؾ قطاض

.زاضس، ت ػاى ذطجی هتس تطگطزاس هیكز

38

:خرجی ایي هتذ ػثارت است از

تضیحات ع

Int تؼساز پیاهک

اگر هطتروی دارای چذیي ضوار اختصاصی تاضذ، ترای وسة اعالع از تؼذاد پیاهىای دریافتی ترای ر ضوار،

. تا ضوار هردظر، فراخای وذToتایذ ر تار ایي هتذ را ت صرت همذاردی پاراهتر






:نکات ههن راجع ته وتسرویس دریافت پیاهک

ت ػاى یک پاضاهتط ضزی تطای اضؾال زضذاؾت اؾتفاز idزض تطذی اظ هتسای ایي تؿطیؽ اظ پاضاهتط .1

. اؾتفاز کیسList ،getFirst ،getLast هیتایس اظ هتسایی هاس IDقس اؾت، تطای هقساضزی ت پاضاهتط

"Service is disabled "اگط هسیط ؾیؿتن، کل ؾطیؽ اضؾال زضیافت پیاهک ضا هتقف کطز تاقس، پیغام .2

.ت وایف زض هیآیس

39

HTTPدریافت پیاهک تا استفاده از پروتکل

ؾظ قطکت ػهط فطا اضتثاط ت کاضتطاى، زضیافت پیاهک تا اؾتفاز اظ پطتکل .1 اظ زیگط اهکاات اضائ قس ت

Httpت قطکت (هالک قواض اذتهانی)زض ایي ضـ یک آزضؼ ایتطتی اظ ؾی هكتطک . هیثاقس

گیطسگاى پیاهکای )ػهط فطا اضتثاط اضائ هیگطزز تا کلی پیاهکای اضؾال قس اظ عطف هراعثیي

تا ایي ضـ ظهای ک هكتطک پیاهکی ضا زضیافت هیکس، اعالػات . ت ایي آزضؼ اضؾال قس (هكتطک

. ت آزضؼ ا اضؾال هیكسQueryStringپیاهک ت نضت یک

تایل "Salam"اضؾال پیاهکی تا هتي : هثال ت هكتطکی تا قواض اذتهانی 09123456789 اظ ؾی قواض ه

3000795

Http://recivesmstest.com/getsms.aspx?From=09123456789&To=3000795&Message=Salam

تایل فطؾتس پیاهک، پاضاهتط Fromواغض ک زض ایي هثال هیثییس ، پاضاهتط تا قواض اذتهانی To تا قواض ه

وچیي آزضؼ . تا هتي پیاهک هقساض هیگیطزMessageهكتطک پاضاهتط

Http://recivesmstest.com/getsms.aspxاظ ؾی هكتطک زض اذتیاض قطکت ػهط فطا اضتثاط قطاض گطفت اؾت .

:چسیي کت زض ضاتغ تا ایي ع اضؾال جز زاضس ک ت قطح ظیط هیثاقس

o اس یک آزضؼ اضجاع پیاهکای زضیافتی زاقت تاقس پیاهک ای زضیافتی توام ط کاضتط تا هی ت

قواض ا ت ویي آزضؼ اضؾال هی قز، اهکاى اضائ یک آزضؼ هجعا ت اظای ط قواض جز

(.ساضز

o ضت . تاقس80 یا 3000آزضؼ اضجاع پیاهک تایس تط ضی پ

o کاضتط تطای اهیت تیكتط هیتاس تاRequest ایی ضا قثل کس ک اظ Static IP ؾطض قطکت

- هی87.107.121.243 اؾتاتیک قطکت ػهط فطا اضتثاط IPآزضؼ ).ػهط فطا اضتثاط اضؾال هیكس

(تاقس

http://recivesmstest.com/getsms.aspx

هاتوک مایپ لاسرا یاهسیورس بو زا هدافتسا...

Documents

Transcript of هاتوک مایپ لاسرا یاهسیورس بو زا هدافتسا...