در این سیستم شما قادر خواهید بود به تعداد نا محدود مخاطب داشته باشید و اطلاعات آنها را در سیستم وارد کنید . ،برای این منظوردر متد هایی که وظیفه گزارش گیری از اطلاعات مخاطبین را دارند علاوه بر پارامتر های کنترلی برای جستجو در اطلاعات مخاطبین سه پارامتر دیگر موجود است. این پارامتر ها عبارتند از:
  • ItemsCount : مشخص کننده تعداد مخاطبین درخواستی می باشد. این مقدار بیش از 100 نمیتواند باشدواگر مقداری بیش از 100، به یکی از متد ها پاس داده شود ، حداکثر 100 تماس ابتدایی را برخواهد گرداند
  • WhatPage : مشخص کننده شماره صفحه درخواستی این گزارش می باشد
  • ref TotalRecords : تعداد کل مخاطبین را برای این جستجو مشخص می کند . به عنوان مثال اگر در کل سیستم 1000 مخاطب برای شما موجود باشد و از این تعداد 800 مخاطب با 0912 شروع می شود و شما درخواست تمام مخاطبینی را داشته باشید که با 0912 شروع میشود،مقدار این پارامتر 800 خواهد بود و برای به دست آوردن اطلاعات تمام مخاطبین نیاز دارید که 8 بار این متد را فراخوانی کنید

خروجی متد : خروجی این متد string با فرمتxml می باشد
نمونه خروجی :

<Result>
   <Contact>
      <ContactID><![CDATA[ 5000 ]]></ContactID>
      <FirstName><![CDATA[ Name5000 ]]></FirstName>
      <LastName><![CDATA[ LastName5000 ]]></LastName>
      <Gender><![CDATA[ 2 ]]></Gender>
      <Description><![CDATA[ Contact Description ]]></Description>
      <Birthdate><![CDATA[ 11/8/1984 ]]></Birthdate>
      <Mobile><![CDATA[ +989120000000 ]]></Mobile>
      <Telephone><![CDATA[ 02188462323 ]]></Telephone>
      <Email><![CDATA[ info@Parhot.com ]]></Email>
      <Address><![CDATA[ Seyyed Khandan - Pishdad - No. 1 ]]></Address>
      <Webpage><![CDATA[ http://www.RahatSMS.com ]]></Webpage>
      <JobTitle><![CDATA[ Developer ]]></JobTitle>
      <Company><![CDATA[ Parhot ]]></Company>
      <MembershipGroups><![CDATA[ 407,416,417 ]]></MembershipGroups>
   </Contact>
</Result>

  • Gender : جنسیت مخاطب مورد نظر است. 0 به معنای خانم ، 1 به معنای آقا و 2 به معنای مشخص نشده است
  • MembershipGroups : کد گروه هایی است که مخاطب مورد نظر در آن عضو می باشد. این کد ها با , جدا شده اند
در آخر بر این نکته تاکيد مینماييم که در هر بار فراخوانی متد های گزارش اطلاعات مخاطبین ، حداکثر 100 مخاطب ابتدایی برگردانده خواهد شد
GetContactByID(string Username,string Password,int ContactID)

این متد برای به دست آوردن اطلاعات مخاطب خاص به کار می رود.

  • Username : نام کاربری شما برای استفاده از وب سرویس
  • Password : کلمه عبور برای استفاده از وب سرویس
  • ContactID : کد مخاطب مورد نظر
در این مثال فرض شده است که برنامه نویس محترم ، وب سرویس پرهات را با عنوان com.ParhotAdvanced به پروژه خود اضافه کرده است
private string GetContactByID()
{
   com.ParhotAdvanced.ParhotContactWS objWS = new com.ParhotAdvanced.ParhotContactWS();

   return objWS.GetContactByID("YOUR-USERNAME", "YOUR-PASSWORD",[CONTACT-ID]);
}

GetAllContacts(string Username,string Password,int ItemsCount,int WhatPage,ref int TotalRecords)

این متد برای به دست آوردن اطلاعات تمام مخاطبین که در هر گروهی ممکن است عضو باشند به کار میرود.

  • Username : نام کاربری شما برای استفاده از وب سرویس
  • Password : کلمه عبور برای استفاده از وب سرویس
  • ItemsCount : تعداد مخاطب درخواستی که حداکثر 100 میتواند باشد
  • WhatPage : شماره صفحه گزارش درخواستی
  • ref TotalRecords : تعداد کل مخاطبین در گزارش فعلی
GetContacts(string Username,string Password,int GroupID,int ItemsCount,int WhatPage,ref int TotalRecords)

این متد برای برای به دست آوردن اطلاعات تمام مخاطبین یک گروه خاص به کار میرود.

  • Username : نام کاربری شما برای استفاده از وب سرویس
  • Password : کلمه عبور برای استفاده از وب سرویس
  • GroupID : کد گروه مخاطبین
  • ItemsCount : تعداد مخاطب درخواستی که حداکثر 100 میتواند باشد
  • WhatPage : شماره صفحه گزارش درخواستی
  • ref TotalRecords : تعداد کل مخاطبین در گزارش فعلی
GetContactsByMobile(string Username,string Password,string Mobile,int ItemsCount,int WhatPage,ref int TotalRecords)

این متد برای جستجوی شماره موبایل های درخواستی در تمام مخاطبین به کار میرود .

موتور جستجو روی موبایل ها به ابتدای شماره موبایل حساس است و شماره های موبایل با فرمت 989xxxxxxxxx+ ذخیره میشود. یعنی موتور جستجو گر شماره موبایل هایی را انتخاب میکند که ابتدای آنها با مقدار درخواستی شما برابر باشد.بنابر این برای جستجوی یک شماره موبايل خاص و یا بازه ای از شماره موبایل ها ، این پارامتر حتماً بايد با 989+ شروع شود
  • Username : نام کاربری شما برای استفاده از وب سرویس
  • Password : کلمه عبور برای استفاده از وب سرویس
  • Mobile : شماره موبایل درخواستی برای جستجو
  • ItemsCount : تعداد مخاطب درخواستی که حداکثر 100 میتواند باشد
  • WhatPage : شماره صفحه گزارش درخواستی
  • ref TotalRecords : تعداد کل مخاطبین در گزارش فعلی
GetContactsByMobileInAGroup(string Username,string Password,int GroupID,string Mobile,int ItemsCount,int WhatPage,ref int TotalRecords)

این متد برای جستجوی شماره موبایل های درخواستی در یک گروه خاص به کار میرود .

موتور جستجو روی موبایل ها به ابتدای شماره موبایل حساس است و شماره های موبایل با فرمت 989xxxxxxxxx+ ذخیره میشود. یعنی موتور جستجو گر شماره موبایل هایی را انتخاب میکند که ابتدای آنها با مقدار درخواستی شما برابر باشد.بنابر این برای جستجوی یک شماره موبايل خاص و یا بازه ای از شماره موبایل ها ، این پارامتر حتماً بايد با 989+ شروع شود
  • Username : نام کاربری شما برای استفاده از وب سرویس
  • Password : کلمه عبور برای استفاده از وب سرویس
  • GroupID : کد گروه مخاطبین
  • Mobile : شماره موبایل درخواستی برای جستجو
  • ItemsCount : تعداد مخاطب درخواستی که حداکثر 100 میتواند باشد
  • WhatPage : شماره صفحه گزارش درخواستی
  • ref TotalRecords : تعداد کل مخاطبین در گزارش فعلی