Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
RestClient.h
RestClient.m
SoapClient.h
SoapClient.m
mpObjC-quickStart.zip

README.md

melipayamak Objective-C

معرفی وب سرویس ملی پیامک

ملی پیامک یک وب سرویس کامل برای ارسال و دریافت پیامک و پیامک صوتی و مدیریت کامل خدمات دیگر است که براحتی میتوانید از آن استفاده کنید.


نصب

قبل از نصب نیاز به ثبت نام در سایت ملی پیامک دارید.

ثبت نام به همراه دریافت 200 پیامک هدیه جهت تست وبسرویس

نحوه استفاده

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

NSString *username = @"username";
NSString *password = @"password";
NSString *to = @"9123456789";
NSString *from = @"5000...";
NSString *message = @"تست وب سرویس ملی پیامک";
BOOL isFlash = false;
SoapClient *soapClient = [[SoapClient alloc] initCred:username password:password];
[soapClient SendSimpleSMS2:to sender:from msg:message flash:isFalse];

از آنجا که وب سرویس ملی پیامک تنها محدود به ارسال پیامک نیست شما از طریق زیر میتوانید به وب سرویس ها دسترسی کامل داشته باشید:

// وب سرویس پیامک
RestClient *restClient = [[RestClient alloc] initCred:username password:password];
SoapClient *soapClient = [[SoapClient alloc] initCred:username password:password];

تفاوت های وب سرویس پیامک rest و soap

از آنجا که ملی پیامک وب سرویس کاملی رو در اختیار توسعه دهندگان میگزارد برای راحتی کار با وب سرویس پیامک علاوه بر وب سرویس اصلی soap وب سرویس rest رو هم در اختیار توسعه دهندگان گزاشته شده تا راحتتر بتوانند با وب سرویس کار کنند. تفاوت اصلی این دو در تعداد متد هاییست که میتوانید با آن کار کنید. برای کار های پایه میتوان از وب سرویس rest استفاده کرد برای دسترسی بیشتر و استفاده پیشرفته تر نیز باید از وب سرویس باید از وب سرویس soap استفاده کرد. جهت مطالعه بیشتر وب سرویس ها به قسمت وب سرویس پنل خود مراجعه کنید.


اطلاعات بیشتر

برای مطالعه بیشتر و دریافت راهنمای وب سرویس ها و آشنایی با پارامتر های ورودی و خروجی وب سرویس به صفحه معرفی وب سرویس ملی پیامک مراجعه نمایید . در تمامی متدها فرض گرفته ایم ARC در محیط کاربری شما فعال است. بنابراین از آزاد سازی حافظه بصورت دستی صرف نظر نمودیم.


وب سرویس پیامک

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

ارسال

[restClient Send:to sender:from msg:message flash:isFlash];
[soapClient SendSimpleSMS2:to sender:from msg:message flash:isFlash];
در آرگومان سوم روش soap میتوانید از هر تعداد مخاطب به عنوان آرایه استفاده کنید

ارسال از خط خدماتی اشتراکی

[restClient SendByBaseNumber:text to:toNum bodyId:bid];
[soapClient SendByBaseNumber2:text to:toNum bodyId:bid];

دریافت وضعیت ارسال

[restClient GetDelivery:recId];
[soapClient GetDelivery:recId];
[soapClient GetDeliveries:array];

لیست پیامک ها

[restClient GetMessages:location from:from index:index count:count];
[soapClient getMessages:location from:from index:index count:count];
// جهت دریافت به صورت رشته ای
[soapClient GetMessagesByDate:location from:from index:index count:count dateFrom:dFrom dateTo:dTo];
//جهت دریافت بر اساس تاریخ
[soapClient GetUsersMessagesByDate:location from:from index:index count:count dateFrom:dFrom dateTo:dTo];
// جهت دریافت پیام های کاربران بر اساس تاریخ 

موجودی

[restClient GetCredit];
[soapClient GetCredit];

تعرفه پایه / دریافت قیمت قبل از ارسال

[restClient GetBasePrice];
[soapClient GetSmsPrice:irancellCount mtnCnt:mtnCount from:from msg:text];

لیست شماره اختصاصی

[soapClient GetUserNumbers];

بررسی تعداد پیامک های دریافتی

[soapClient GetInboxCount:isRead];
//پیش فرض خوانده نشده 

ارسال پیامک پیشرفته

[soapClient SendSms:arrayOfTo from:from msg:text flash:isFlash uhd:uhd arrayOfRecId:array arrayOfStatus:stArray];

مشاهده مشخصات پیام

[soapClient GetMessagesReceptions:msgId fromrows:from];

حذف پیام دریافتی

[soapClient RemoveMessages2:location arrayOfMsgId:msgIds];

ارسال زماندار

[soapClient AddSchedule:to from:from msg:text isFlash:isflash sdt:scheduleDateTime prd:period];

ارسال زماندار متناظر

[soapClient AddMultipleSchedule:arrayOfTo from:from arrayOfMsg:msgs isFlash:isflash arrayOfSt:stArray period:period];

ارسال سررسید

[soapClient AddUsance:to from:from msg:text isFlash:isflash ss:scheduleStartDateTime rpt:repeat se: scheduleEndDateTime];

مشاهده وضعیت ارسال زماندار

[soapClient GetScheduleStatus:schId];

حذف پیامک زماندار

[soapClient RemoveSchedule:schId];

وب سرویس پیامک صوتی

ارسال پیامک همراه با تماس صوتی

[soapClient SendSMSWithSpeechText:smsBody spch:speechBody from:from to:to];

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

[soapClient SendSMSWithSpeechTextBySchduleDate:smsBody spch:speechBody from:from to:to sche:scheduleDate];

دریافت وضعیت پیامک همراه با تماس صوتی

[soapClient GetSendSMSWithSpeechTextStatus:recId];

تماس انبوه زماندار

[soapClient SendBulkSpeechText:title body:body receivers:receivers DateToSend:DateToSend repeatCount:repeatCount];

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

[soapClient SendBulkVoiceSMS:title voiceFileId:voiceFileId receivers:receivers DateToSend:DateToSend repeatCount:repeatCount];

آپلود فایل صوتی

[soapClient UploadVoiceFile:title base64StringFile:base64StringFile];

وب سرویس ارسال انبوه/منطقه ای

دریافت شناسه شاخه های بانک شماره

[soapClient GetBranchs:owner];

اضافه کردن یک بانک شماره جدید

[soapClient AddBranch:branchName owner:owner];

اضافه کردن شماره به بانک

[soapClient AddNumber:branchId arrayOfNum:Numbers];

حذف یک بانک

[soapClient RemoveBranch:branchId];

ارسال انبوه از طریق بانک

[soapClient AddBulk:from branch:branch bulkType:bulkType title:title msg:message rangeF:rangeFrom rangeT:rangeTo date:DateToSend reqCnt:requestCount rowFrom:rowFrom];

تعداد شماره های موجود

[soapClient GetBulkCount:branch rangeF:rangeFrom rangeT:rangeTo];

گزارش گیری از ارسال انبوه

[soapClient GetBulkReceptions:bulkId fromRows:fromRows];

تعیین وضعیت ارسال

[soapClient GetBulkStatus:bulkId sent:sent failed:failed status:status];

تعداد ارسال های امروز

[soapClient GetTodaySent];

تعداد ارسال های کل

[soapClient GetTotalSent];

حذف ارسال منطقه ای

[soapClient RemoveBulk:bulkId];

ارسال متناظر

[soapClient SendMultipleSMS:arrayOfTo from:from arrayOfMsg:Messages isFlash:isflash uhd:udh arrayOfRecIds:Ids status:status];

نمایش دهنده وضعیت گزارش گیری

[soapClient UpdateBulkDelivery:bulkId];

وب سرویس تیکت

ثبت تیکت جدید

[soapClient AddTicket:title content:content alert:aletWithSms];

جستجو و دریافت تیکت ها

[soapClient GetReceivedTickets:ticketOwner type:ticketType keyword:keyword];

دریافت تعداد تیکت های کاربران

[soapClient GetReceivedTicketsCount:ticketType];

دریافت تیکت های ارسال شده

[soapClient GetSentTickets:ticketOwner type:ticketType keyword:keyword];

دریافت تعداد تیکت های ارسال شده

[soapClient GetSentTicketsCount:ticketType];

پاسخگویی به تیکت

[soapClient ResponseTicket:ticketId type:type content:content alert:alertWithSms];

وب سرویس دفترچه تلفن

اضافه کردن گروه جدید

[soapClient AddGroup:groupName desc:Descriptions show:showToChilds];

اضافه کردن کاربر جدید

[soapClient AddContact:options];

بررسی موجود بودن شماره در دفترچه تلفن

[soapClient CheckMobileExistInContact:mobileNumber];

دریافت اطلاعات دفترچه تلفن

[soapClient GetContacts:groupId keyword:keyword count:cnt];

دریافت گروه ها

[soapClient GetGroups];

ویرایش مخاطب

[soapClient ChangeContact:options];

حذف مخاطب

[soapClient RemoveContact:mobilenumber];

دریافت اطلاعات مناسبت های فرد

[soapClient GetContactEvents:contactId];

وب سرویس کاربران

ثبت فیش واریزی

[soapClient AddPayment:options];

اضافه کردن کاربر جدید در سامانه

[soapClient AddUser:options];

اضافه کردن کاربر جدید در سامانه(کامل)

[soapClient AddUserComplete:options];

اضافه کردن کاربر جدید در سامانه(WithLocation)

[soapClient AddUserWithLocation:options];

بدست آوردن ID کاربر

[soapClient AuthenticateUser];

تغییر اعتبار

[soapClient ChangeUserCredit:amount desc:description user:targetUsername gTax:GetTax];

فراموشی رمز عبور

[soapClient ForgotPassword:mobileNumber email:emailAddress user:targetUsername];

دریافت تعرفه پایه کاربر

[soapClient GetUserBasePrice:targetUsername];

دریافت اعتبار کاربر

[soapClient GetUserCredit:targetUsername];

دریافت مشخصات کاربر

[soapClient GetUserDetails:targetUsername];

دریافت شماره های کاربر

[soapClient GetUserNumbers];

دریافت تراکنش های کاربر

[soapClient GetUserTransactions:targetUsername creditType:creditType dateF:dateFrom dateT:dateTo keyword:keyword];

دریافت اطلاعات کاربران

[soapClient GetUsers];

دریافت اطلاعات فیلترینگ

[soapClient HasFilter:text]

حذف کاربر

[soapClient RemoveUser:targetUsername];

مشاهده استان ها

[soapClient GetProvinces];

مشاهده کد شهرستان

[soapClient GetCities:provinceId];

مشاهده تاریخ انقضای کاربر

[soapClient GetExpireDate]
You can’t perform that action at this time.