‫ﺑﮫ ﻧﺎم ﺧﺪا‬

‫راھﻨﻤﺎی وﺑﺴﺮوﯾﺲ ﭘﯿﺎﻣﮑﯽ ﺳﺎﻣﺎﻧﮫ‬

‫ﻧﮕﺎرش ‪١‬‬

‫ﭘﺎﯾﯿﺰ ‪٣٩‬‬

‫ﻣﻘﺪﻣﮫ‪:‬‬

‫ھﺪف از اﻧﺘﺸﺎر اﯾﻦ راھﻨﻤﺎ ﺑﺮای ﭼﮕﻮﻧﮕﯽ ﻣﺘﺼﻞ ﺷﺪن ﺑﮫ وﺑﺴﺮوﯾﺲ ﺳﺎﻣﺎﻧﮫ ﭘﯿﺎﻣﮏ ﺑﺮای ﻋﻤﻠﯿﺎت ھﺎی ﻣﺨﺘﻠﻒ ﻻزﻣﮫ ﻣﯿﺒﺎﺷﺪ‪.‬‬

‫ﻧﺤﻮه و ﭘﺮوﺗﮑﻞ دﺳﺘﺮﺳﯽ‪:‬‬

‫ﺑﺮای اﺗﺼﺎل ﺑﮫ اﯾﻦ وﺑﺴﺮوﯾﺲ ﮐﮫ ﺑﺮ اﺳﺎس اﺳﺘﺎﻧﺪارد ‪ wsdl‬اﺳﺖ ﺷﻤﺎ ﺑﺎﯾﺴﺘﯽ ارﺗﺒﺎط ﺧﻮد را ﺑﺎ ﻟﯿﻨﮏ ‪ wsdl‬ﺑﮫ آدرس زﯾﺮ ﺑﺮﻗﺮار‬
‫ﻧﻤﺎﯾﯿﺪ ‪:‬‬

‫‪http://185.4.28.100/class/sms/webservice3/server.php?wsdl‬‬

‫ﻣﺘﺪھﺎی ﻣﻮﺟﻮد‪:‬‬

‫‪GetCredit‬‬

‫‪SendSMS‬‬

‫‪SendMultipleSMS‬‬

‫‪GetStatus‬‬

‫ﻣﺘﺪ ‪GetCredit‬‬

‫اﯾﻦ ﻣﺘﺪ ﺑﺮای درﯾﺎﻓﺖ ﻣﯿﺰان اﻋﺘﺒﺎر ﻓﻌﻠﯽ ﭘﻨﻞ ﺷﻤﺎ ﻣﯿﺒﺎﺷﺪ‬

‫‪GetCredit‬‬
‫ﭘﺎراﻣﺘﺮھﺎی ورودی‬
‫ﻗﻮاﻧﯿﻦ‬ ‫ﺗﻮﺿﯿﺤﺎت‬ ‫ﻧﻮع‬ ‫ﭘﺎراﻣﺘﺮ‬
‫‪string‬‬ ‫‪user‬‬
‫‪string‬‬ ‫‪pass‬‬
 ‫ﺧﺮوﺟﯽ‪:‬‬
‫اﻋﺘﺒﺎر ﺷﻤﺎ ﮐﮫ ﺑﮫ ﺻﻮرت ﯾﮏ ‪ string‬اﺳﺖ‬
‫در ﺻﻮرت اﺷﺘﺒﺎه ﺑﻮدن ﻧﺎم ﮐﺎرﺑﺮی ﯾﺎ رﻣﺰ ﻋﺒﻮر ‪ ١ -‬ﺑﺮﮔﺸﺖ داده ﻣﯿﺸﻮد‬

‫ﻣﺘﺪ ‪sendSMS‬‬

‫اﯾﻦ ﻣﺘﺪ ﺑﺮای ارﺳﺎل ﯾﮏ ﺑﮫ ﭼﻨﺪ اﺳﺘﻔﺎده ﻣﯿﮕﺮدد‬

‫ﺷﻤﺎ ﻣﯿﺘﻮاﻧﯿﺪ ﯾﮏ ﻣﺘﻦ را ﺑﮫ ﯾﮏ ﯾﺎ ﭼﻨﺪ ﮔﯿﺮﻧﺪه ارﺳﺎل ﻧﻤﺎﯾﯿﺪ‬

‫‪sendSMS‬‬

‫ﭘﺎراﻣﺘﺮھﺎی ورودی‬

‫ﻗﻮاﻧﯿﻦ‬ ‫ﺗﻮﺿﯿﺤﺎت‬ ‫ﻧﻮع‬ ‫ﭘﺎراﻣﺘﺮ‬

‫‪string‬‬ ‫‪user‬‬

‫‪string‬‬ ‫‪pass‬‬

‫ﺷﻤﺎره ﻓﺮﺳﺘﻨﺪه‬ ‫‪String‬‬ ‫‪fromNum‬‬

‫آراﯾﮫ ای از ﮔﯿﺮﻧﺪﮔﺎن ﮐﮫ در‬ ‫ﮔﯿﺮﻧﺪﮔﺎن‬ ‫‪Array of string‬‬ ‫‪toNum‬‬

‫ﻧﮭﺎﯾﺖ ﻣﯿﺘﻮاﻧﺪ ‪ 60‬ﻋﺪد در‬
‫ﯾﮏ درﺧﻮاﺳﺖ ﺑﺎﺷﺪ‬
‫ﻣﺘﻦ ﭘﯿﺎم‬ ‫ﻣﺘﻦ ﭘﯿﺎم‬ ‫‪string‬‬ ‫‪messageContent‬‬

‫ﺑﺮای ارﺳﺎل ﺑﮫ ﺻﻮرت‬ ‫ﻧﻮع ﭘﯿﺎم‬ ‫‪string‬‬ ‫‪messageType‬‬

‫ﻧﺮﻣﺎل ‪0‬‬
‫و ﺑﺮای ارﺳﺎل ﺑﺼﻮرت‬
‫ﻓﻠﺶ ‪١‬‬
‫ﺧﺮوﺟﯽ‪:‬‬

‫ﺑﺼﻮرت ﯾﮏ آراﯾﮫ ﺑﺎز ﻣﯿﮕﺮدد‬

‫‪: uid‬ﮐﮫ ھﻤﺎن ﺷﻨﺎﺳﮫ واﺣﺪ ھﺮ ﭘﯿﺎم اﺳﺖ ﮐﮫ ﺑﻌﺪا ﺑﺮای ﮔﺮﻓﺘﻦ دﻟﯿﻮری اﺳﺘﻔﺎده ﻣﯿﮕﺮدد‬
‫‪: state‬درﺻﻮرﺗﯽ ﮐﮫ وﺿﻌﯿﺖ ﭘﯿﺎم ھﻤﺎن ﻣﻮﻗﻊ ﻣﺸﺨﺺ ﺷﻮد وﺿﻌﯿﺖ در اﯾﻦ ﻓﯿﻠﺪ داده ﻣﯿﺸﻮد‬

‫ﻣﺘﺪ ‪sendMultipleSMS‬‬

‫اﯾﻦ ﻣﺘﺪ ﺑﺮای ارﺳﺎل ﻧﻈﯿﺮ ﺑﮫ ﻧﻈﯿﺮ اﺳﺘﻔﺎده ﻣﯿﮕﺮدد ‪.‬‬

‫‪sendMultipleSMS‬‬
‫ﭘﺎراﻣﺘﺮھﺎی ورودی‬
‫ﻗﻮاﻧﯿﻦ‬ ‫ﺗﻮﺿﯿﺤﺎت‬ ‫ﻧﻮع‬ ‫ﭘﺎراﻣﺘﺮ‬
‫‪string‬‬ ‫‪user‬‬
‫‪string‬‬ ‫‪pass‬‬
‫ﺷﻤﺎره ﻓﺮﺳﺘﻨﺪه‬ ‫‪Array of string‬‬ ‫‪fromNum‬‬
 ‫‪Array of string‬‬ ‫‪toNum‬‬
‫آراﯾﮫ ای از ﮔﯿﺮﻧﺪﮔﺎن ﮐﮫ در‬ ‫ﮔﯿﺮﻧﺪﮔﺎن‬ ‫‪Array of string‬‬ ‫‪messageContent‬‬
‫ﻧﮭﺎﯾﺖ ﻣﯿﺘﻮاﻧﺪ ‪ 60‬ﻋﺪد در‬
‫ﯾﮏ درﺧﻮاﺳﺖ ﺑﺎﺷﺪ‬
‫ﺑﺮای ارﺳﺎل ﺑﮫ ﺻﻮرت‬ ‫ﻧﻮع ﭘﯿﺎم‬ ‫‪Array of string‬‬ ‫‪messageType‬‬
‫ﻧﺮﻣﺎل ‪0‬‬
‫و ﺑﺮای ارﺳﺎل ﺑﺼﻮرت‬
‫ﻓﻠﺶ ‪١‬‬
‫ﺧﺮوﺟﯽ ‪:‬‬
‫ﺑﺼﻮرت ﯾﮏ آراﯾﮫ ﺑﺎز ﻣﯿﮕﺮدد‬
‫‪: uidmulti‬ﮐﮫ ھﻤﺎن ﺷﻨﺎﺳﮫ واﺣﺪ ھﺮ ﭘﯿﺎم اﺳﺖ ﮐﮫ ﺑﻌﺪا ﺑﺮای ﮔﺮﻓﺘﻦ دﻟﯿﻮری اﺳﺘﻔﺎده ﻣﯿﮕﺮدد‬
‫‪: statemulti‬درﺻﻮرﺗﯽ ﮐﮫ وﺿﻌﯿﺖ ﭘﯿﺎم ھﻤﺎن ﻣﻮﻗﻊ ﻣﺸﺨﺺ ﺷﻮد وﺿﻌﯿﺖ در اﯾﻦ ﻓﯿﻠﺪ داده ﻣﯿﺸﻮد‬

‫ﻣﺘﺪ ‪GetStatus‬‬

‫اﯾﻦ ﻣﺘﺪ ﺑﺮای ﮔﺮﻓﺘﻦ وﺿﻌﯿﺖ ﭘﯿﺎم ھﺎ ﺑﺎ اﺳﺘﻔﺎده از ﺷﻨﺎﺳﮫ ھﺎﯾﯽ ﮐﮫ در زﻣﺎن‬

‫ارﺳﺎل درﯾﺎﻓﺖ ﮐﺮده اﯾﺪ ﻣﯿﺒﺎﺷﺪ‬

‫‪GetStatus‬‬
‫ﭘﺎراﻣﺘﺮھﺎی ورودی‬

‫ﻗﻮاﻧﯿﻦ‬ ‫ﺗﻮﺿﯿﺤﺎت‬ ‫ﻧﻮع‬ ‫ﭘﺎراﻣﺘﺮ‬

‫‪string‬‬ ‫‪user‬‬

‫‪string‬‬ ‫‪pass‬‬

‫ﺷﻨﺎﺳﮫ ھﺎی ارﺳﺎل‬ ‫‪Array of string‬‬ ‫‪unique_ids‬‬

‫‪:‬ﺧﺮوﺟﯽ‬
‫ﺑﺼﻮرت ﯾﮏ آراﯾﮫ ﺑﺎز ﻣﯿﮕﺮدد‬
‫‪: uidgetstatus‬ﮐﮫ ھﻤﺎن ﺷﻨﺎﺳﮫ واﺣﺪ ھﺮ ﭘﯿﺎم اﺳﺖ ﮐﮫ ارﺳﺎل ﮐﺮده اﯾﺪ‬
‫‪: stategetstatus‬وﺿﻌﯿﺖ ﭘﯿﺎم ارﺳﺎل ﺷﺪه‬

‫وﺿﻌﯿﺖ ھﺎ‬

‫در ﺣﺎل ارﺳﺎل‬ ‫‪1‬‬

‫ﻣﺸﮑﻞ ﻣﺨﺎﺑﺮاﺗﯽ‬ ‫‪2‬‬
‫رﺳﯿﺪه ﺑﮫ ﻣﺨﺎﺑﺮات‬ ‫‪3‬‬
‫رﺳﯿﺪه ﺑﮫ ﮔﻮﺷﯽ‬ ‫‪4‬‬
‫ﻧﺮﺳﯿﺪه ﺑﮫ ﮔﻮﺷﯽ‬ ‫‪5‬‬
‫ﺑﺮﮔﺸﺘﯽ‬ ‫‪6‬‬
‫ﺷﻨﺎﺳﮫ وﺟﻮد ﻧﺪارد‬ ‫‪E8‬‬
 ‫در ھﺮ ﮐﺪام از ﻣﺘﺪھﺎی ارﺳﺎل اﮔﺮ ﺧﻄﺎﯾﯽ رخ دھﺪ در ھﻤﺎن ﻓﯿﻠﺪ ‪ uid‬ﻣﺸﺨﺺ ﻣﯿﮕﺮدد‬

‫ﺷﻨﺎﺳﮫ ﺧﻄﺎھﺎ و ﻣﻌﻨﯽ ھﺮﮐﺪام ﺑﮫ ﺷﺮح زﯾﺮ اﺳﺖ‬

‫ﻧﺎم ﮐﺎرﺑﺮی ﯾﺎ رﻣﺰ ﻋﺒﻮر اﺷﺘﺒﺎه ﻣﯿﺒﺎﺷﺪ‬ ‫‪E11‬‬

‫ﺑﯿﺸﺘﺮ از ﻇﺮﻓﯿﺖ ‪ 60‬ﻋﺪد در ﯾﮏ ﺑﺴﺘﮫ ارﺳﺎل‬ ‫‪E61‬‬
‫ﻧﻤﻮده اﯾﺪ‬
‫ﻣﺸﮑﻠﯽ ﺑﺎ ﺷﻤﺎره ﻓﺮﺳﺘﻨﺪه وﺟﻮد دارد‬ ‫‪E7‬‬