منو

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

وب سرویس ها برنامه (قطعه کد) هایی هستند که تحت وب قابل دسترسی اند و از طریق پروتکل های استانداردی مانند Http به انتقال و مبادله دیتا با سایر برنامه های کاربردی می پردازند. اساس کار وب سرویس (Web Service) ها بر پایه دریافت و تولید پیغام بنیان گذاری شده است. بدین معنی که آنها منتظر می مانند که کلاینت ها به آنها وصل شده و بنا به درخواست کلاینت ها به آن ها پاسخ می دهند . راه ارتباطی انتقال این پیغام ها یک آدرس است که شما میتوانید با افزودن آن در برنامه خود از خصوصیات آن استفاده نمائید

Send از طریق این متد می توانید پیامک های خود را به شماره/شماره های انتخابی خود ارسال نمایید.

ورودی ها

نام نوع شرح
username string نام کاربری شما در سامانه پیامک آموت
password string رمز عبور شما در سامانه پیامک آموت
Number string شماره ارسال پیامک
recipient string شماره دریافت کنندگان
میتواند بصورت تکی یا لیستی از شماره ها باشد که با استفاده از کاراکتر ; جدا می شوند
body string متن پیامک
flash bool
Unicode bool برای پیامک هایی با متن فارسی بایستی مقدار آن True باشد
encode bool در صورتی که متن پیامک unicode شده و بصورت Base64 ارسال نموده اید بایستی مقدار آن True باشد
SendDateTime DateTime زمان ارسال پیامک
(درصورتیکه مقدار بصورت Null یا زمان گذشته باشد ، زمان حال برای ارسال در نظر گرفته میشود)

خروجی ها


مقدار خروجی عنوان خروجی
-1 مقدار ورودی ها صحیح نمی باشد
همچنین اگر unicode = true ست شده باشد متن پیامک بصورت Base64 نیست
100 نام کاربری یا رمز عبور اشتباه می باشد
102 هزینه پیامکها از اعتبار شما بیشتر می باشد
104 Number (شماره ارسال پیامک) متعلق به شما نمی باشد
105 خطای ناشناخته
106 یک/چندین از شماره های دریافت کنندگان پیامک صحیح نمی باشد
خروجی XML گزارش ارسال پیامک شامل :

لیست { شماره دریافت کننده Number , شماره پیامک RefID }

اعتبار باقیمانده Balance

نمونه کدها

Receive با استفاده از این متد میتوانید پیامک های دریافتی خود را به تعداد اخیر دریافت نمایید.

* نکته : در هر بار اجرای این متد فقط یکبار پیامک ها را به شما نشان می دهد.

ورودی ها

نام نوع شرح
username string نام کاربری شما در سامانه پیامک آموت
password string رمز عبور شما در سامانه پیامک آموت
qty int تعداد پیامها

خروجی ها


مقدار خروجی عنوان خروجی
100 نام کاربری یا رمز عبور اشتباه می باشد
107 مقدار ورودی ها صحیح نمی باشد
خروجی XML گزارش پیامکهای دریافتی شامل :

لیست { شماره پیامک MessageID ,
شماره فرستنده پیامک Number ,
شماره دریافت پیامک Recipient ,
متن پیامک MsgBody ,
زمان دریافت پیامک MsgDateTime }

نمونه کدها

GetDelivery با استفاده از این متد می توانید دلیوری پیامک ارسالی را بررسی نمایید.

ورودی ها

نام نوع شرح
RefID string شماره/شماره های پیامک ارسالی
میتواند بصورت تکی یا لیستی از شماره ها باشد که با استفاده از کاراکتر ; جدا می شوند

خروجی ها

مقدار خروجی عنوان خروجی
107 مقدار ورودی ها صحیح نمی باشد
error خطای ناشناخته
خروجی XML گزارش دلیوری پیامک های ارسالی شامل :

لیست { شماره پیامک RefID ,
وضعیت دلیوری DeliveryCode }

DeliveryCode شرح شناسه
0ارسال شده به مخابرات
1رسیده به گوشی
2نرسیده به گوشی
3خطای مخابراتی
5خطای نامشخص
8رسیده به مخابرات
16نرسیده به مخابرات
35لیست سیاه
100نامشخص
200ارسال شده
300فیلتر شده
400در لیست ارسال
500عدم پذیرش
501ارسال با آوانک
502ارسال با خط پشتیبان
900در صف ارسال
950شماره اشتباه
951بدون پیام
952پیش شماره اشتباه

نمونه کدها

Status با استفاده از این متد میتوانید وضعیت حساب کاربری خود را بررسی نمایید.

ورودی ها

نام نوع شرح
username string نام کاربری شما در سامانه پیامک آموت
password string رمز عبور شما در سامانه پیامک آموت

خروجی ها

مقدار خروجی عنوان خروجی
100 نام کاربری یا رمز عبور اشتباه می باشد
خروجی XML گزارش ارسال پیامک شامل :

شماره فعلی ارسال Number ,
باقیمانده اعتبار Balance,
تعرفه فارسی UnicodePrice,
تعرفه لاتین AnsiPrice,
وضعیت ارسال Status,
تاریخ ثبت نام RegisterDate

نمونه کدها

AmootWebSMS WinFormSample نمونه کد نوشته شده به زبان سی شارپ (Windows Form)

نمونه کد

حجم فایل پروژه : 155KB
زبان برنامه نویسی : C# WinForm - .Net 4.0

استفاده از مطالب سایت پیامک آموت فقط برای مقاصد غیر تجاری و با ذکر منبع بلامانع است. کلیه حقوق این سایت متعلق به نرم افزاری آموت می‌باشد.

Top