API وب سرویس ارسال اس ام اس

متد SendSms :برای ارسال پیامک باید از این متد استفاده نمود . پارامترهای مربوط به این متد در جدول ذیل آورده شده اند. مقدار بازگشتی این متد رشته ای است که مقادیر آن نشانگر شرایط پیامک می باشد. بدین ترتیب که اگر پارامترها صحیح باشند و پیامک به صورت موفقیت آمیز در سیستم پیام دهی قرار می گیرد به ازای هر پیامک به صورت موفقیت آمیز در سیستم پیام دهی قرار گیرد به ازای هر پیامک یک شناسه پیام (SmsId) و در غیر اینصورت کد خطای مربوطه در خروجی قرار می گیرد .

توجه: لیست انواع خطاها و توضیحات مربوط به هر کدام در انتهای این راهنما آورده شده است :

 

نام متد

SendSms

ورودی

نام پارامترها

نوع پارامترها

اجباری / اختیاری

توضیح

SmsText

String

اجباری

متن پیامک

SenderNumber

Array of String

اجباری

شماره فرستنده (شماره اختصاصی یا همان شماره XXXX3000)

ReceiveNumber

String

Array of String

اجباری

شماره گیرنده ( شماره موبایل مقصد )

SendType

SendType

اجباری

روش ارسال

SmsMode

SmsMode

اجباری

روش ذخیره سازی در گوشی موبایل

توضیح : پارامترهای Username و Password و Domainاز روی Header ارسالی سرویس SOAP خوانده می شوند.

خروجی

نوع پارامتر

توضیح

String of Long integer

رشته ای است شامل شناسه پیام و یا کد خط


درهنگام ست کردن پارامتر متن به نکات زیر توجه فرمایید :

به طور کلی طول استاندارد هر پیامک 140 بایت است . در نتیجه طول استاندارد یک پیامک فارسی 70 کاراکتر (هر کاراکتر برابر 2 بایت است )، اندازه استاندارد پیامک باینری 140 بایت و طول استاندارد یک پیامک لاتین 160کاراکتر (160کاراکتر 7 برابر 2 بیتی) می باشد. باید به این نکته توجه داشته باشید که حتی وجود یک کاراکتر فارسی در پیامک باعث تغییر رمز نگاری آن پیامک شده و در نتیجه پیامک به طور کلی فارسی محاسبه می شود و طول آن بر اساس طول پیامک فارسی (70کاراکتر)در نظر گرفته خواهد شد.

جهت ایجاد سهولت برای مشترکین امکان ارسال پیامک های بزرگتر از طول استاندارد فراهم گشته است و مشترکین می توانند بدون نیاز به شکستن متن های طولانی،آن ها را به صورت یکپارچه ارسال نمایند.فقط در هنگام استفاده باید توجه داشته باشید که به ازای هر بخش از یک پیامک فارسی طولانی،3 کاراکتر و به ازای هر بخش از یک پیامک لاتین طولانی،7 کاراکتر از فضای استاندارد متن پیامک به کد UDH اختصاصی پیدا می کند. یعنی در واقع هر بخش از پیامک چند قسمتی فارسی حداکثر 67 کاراکتر و هر بخش از پیامک چند قسمتی لاتین حداکثر 153 کاراکتر را در خود جای می دهد.

 1. شماره گیرنده یا شماره موبایل که باید به طور مثال به صورت زیر در متد تعریف شوند: 0912XXXXXXXX

2. شماره فرستنده در هنگام ارسال می تواند به صورت زیر در متد تعریف شود: 3000XXXX

 توضیح :برای ارسال پیامک هایی که طول آنها از طول استاندارد بیشتر است ، سیستم به صورت خودکار پیامک را به تعداد بخش لازم تقسیم کرده و ارسال می نماید. لازم به توضیح است که میزان اعتبار کسر شده ز کاربر بر اساس تعداد بخش های متن پیام می باشد.

 3. با تنظیم پارامتر SmsMode می توان نحوه دریافت و نمایش پیامک ارسالی بر روی گوشی گیرنده را به دلخواه تغییر داد، مقادیر قابل قبول برای این پارامتر سه مقدار Alert,SaveInPhone,SaveInSim می باشد.

 Alert : پیامک به صورت مستقیم بر روی صفحه موبایل شخص گیرنده فرستاده می شود . در این حالت پیامک در موبایل یا سیم کارت شخص گیرنده به صورت اتوماتیک ذخیره نمی شود و با خروج از آن از روی گوشی حذف می شود(پیامک خبری).

SaveInPhone : پیامک در حافظه موبایل شخص گیرنده ذخیره می شود(پیامک عادی )

 SaveInSim : پیامک بر روی حافظه سیم کارت شخص گیرنده ذخیره می شود.

 چند نکته مهم:

 طول استاندارد پیامک:سایز استاندارد پیامک 140بایت می باشد. در صورتیکه در متن پیامک از کاراکترهای Adphanumeric استفاده شود طول یک پیامک حداکثر می تواند 160 کاراکتر و در صورتی که از Unicode دوبایتی (کاراکترهای فارسی ) استفاده شود طول یک پیامک حداکثر 70 کاراکتر می تواند باشد.

 انواع حالتهای ممکن ارسال پیامک از طریق متد SendSms :

 ارسال پیام به صورت نظیر به نظیر:در این حالت تمام پارامترهای متد باید دارای آرایه ای هم سایز و متناظر با آرایه پارامتر شماره دریافت کنندگان باشد. در این صورت می توان پیامک های گوناگونی به گیرندگان ارسال نمود.در این صورت باید پارامتر SendType از نوع DynamicText به تابع انتقال داده شود.

ارسال پیامک به صورت یک به چند(بالک) : این حالت تمام پارامترهای متد به جز پارامت شماره دریافت کنندگان باید دارای آرایه ای به طول یک باشددر این صورت یک متن واحد برای چندین نفر (شماره گیرنده) فرستاده می شود. در این صورت باید پارامتر SendType از نوع StaticText به تابع انتقال داده شود.

ads ads
mahak kahrizak

mailپست الکترونیک: info@ tourismscience .ir

SMSسامانه پیام کوتاه: 3000705030 (جهت دریافت پاسخ: ممکن است پیامک های تبلیغاتی خود را مسدود کرده باشید)

contactفرم تماس با ما: کلیلک نمایید
account شماره حسابهای ما: کلیلک نمایید
privacyحریم شخصی کاربران و رفع مسئولیت: کلیک نمایید
 

rss

gpls

face

fina1l

 

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

 

ادامه مطلب