کد php وب سرویس ویرایش مخاطب در پنل پیامک به صورت nusoap
مقدمه
ارسال پیام کوتاه از طریق اینترنت ابزاری پر کاربرد برای استفاده تمامی مشاغل است، با این ابزار میتوان در هر یک از مشاغل مختلف استفاده های مختلفی کرد که این استفاده ها مانند ارسال پیامک تبلیغاتی ، ارسال اس ام اس های اطلاع رسانی و ... است
ارسال پیام کوتاه از طریق اینترنت با روش های پنل کاربری ، App موبایل و وب سرویس قابل استفاده است.
وب سرویس پیام کوتاه این امکان را به برنامه نویس ها میدهد تا بتوانند ارسال پیام کوتاه را در سایت و یا برنامه های خود به شکل سفارشی شده خود استفاده کنند.
وب سرویس پیام کوتاه قابلیت اتصال به تمامی زبان های برنامه نویسی از قبیل .NET ، JAVA ، PHP و .... را دارد که در این مقاله قصد استفاده از وب سرویس پیام کوتاه را با زبان PHP داریم.
برای استفاده از وب سرویس پیام کوتاه در زبان php میتوان به دو روش soap و nusoap استفاده کرد که برای استفاده از روش nusoap باید کتابخانه مخصوص استفاده از آن را دانلود کنید که لینک دانلود آن در انتهای این مقاله گذاشته شده است.
برای اطلاعات بیشتر و همچنین تفاوت های روش soap و nusoap و توضیحات کامل آن میتوانید به مطالب مرتبط دایان این مقاله مراجعه کنید.
توضیحات فنی
وب سرویس ارسال پیامک متدی را با نام UpdateContact دارد که قابلیت ویرایش مخاطب را دارد.
1-Signature: این ورودی از نوع string می باشد که امضای دیجیتال یا کد منحصر به فرد را دریافت می کند.
نحوه تولید : با وارد شدن به پنل پیامکی خود از منوی سمت راست گزینه وب سرویس را انتخاب کرده و از منوی بالا گزینه امضا دیجیتال در دسترس است .
2-FirstName: این ورودی از نوع string می باشد ، این فیلد اجباری است که نام مخاطب جدیدی که ثبت میشود را دریافت میکند.
3-LastName: این ورودی از نوع string می باشد ، این فیلد اجباری است که نام خانوادگی مخاطب جدیدی که ثبت میشود را دریافت میکند.
4-Corporation: این ورودی از نوع string می باشد ، این فیلد اختیاری است و در صورت اینکه مخاطبی که ثبت میشود شرکت باشد نام شرکت را دریافت میکند.
5-Mobile: این ورودی از نوع string می باشد ، این فیلد اجباری است که شماره موبایل مخاطب را دریافت میکند
6-PhoneNumbers: این ورودی از نوع string می باشد ، این فیلد اختیاری است که شماره ثابت مخاطبی که ثبت میشود را دریافت میکند.
7-FaxNumbers: این ورودی از نوع string می باشد ، این فیلد اختیاری است که شماره فاکس مخاطبی که ثبت میشود را دریافت میکند.
8-Birthday: این ورودی از نوع datetime می باشد ، این فیلد اختیاری است تاریخ تولد مخاطب را به میلادی دریافت میکند
9-Email: این ورودی از نوع string می باشد ، این فیل اختیاری است و ایمیل مخاطبی که ثبت میشود را دریافت میکند.
10-GenderType: این ورودی از نوع int می باشد ، این فیلد اختیاری است جنسیت مخاطبی که ثبت میشود را دریافت میکند البته پیشنهاد میشود این فیلد به درستی پر شود (عدد یک خانم و دو آقا)
11-Address: این ورودی از نوع string می باشد ، این فیلد اختیاری است که شماره آدرس مخاطبی که ثبت میشود را دریافت میکند.
12-PostalCode: این ورودی از نوع string می باشد ، این فیلد اختیاری است که پستی مخاطبی که ثبت میشود را دریافت میکند.
13-Description: این ورودی از نوع string می باشد ، این فیلد اختیاری است که توضیحاتی در مورد مخاطبی که ثبت میشود را دریافت میکند.
14-WellcomText: این ورودی از نوع string می باشد ، این فیلد اختیاری است که در صورت پر شدن این فیلد متن نوشته شده به عنوان متن خوش آمد گویی به مخاطب جدید ارسال میشود.
15-GroupIDEncrypt[]: این ورودی آرایه ای از نوع string می باشد ، شناسه گروه یا گروه ها که قصد دارید مخاطب در ان قرار گیرد را دریافت میکند.
16-ContactIDEncrypt: این ورودی از نوع string می باشد ، به صورت رفرنسی بوده و پس از اجرای موفق متد مقدار دهی میشود که شناسه مخاطبی که ایجاد شده است را برمیگرداند.
خروجی : مقداری از نوع int است که راهنمای کامل آن در جدول زیر آمده است
| مقدار | راهنما |
| Return Value( مقدار برگشتی متد) | 1- : امضاء معتبر نیست 100 : انجام شد 101 : گروه های معتبر نیست یا گروهی انتخاب نشده 106 : خطا |
نمونه کد فراخوانی متد:
مطالب مرتبط:
معرفی و دانلود nusoap php | nusoap چیست | مقایسه soap vs nusoap