Melipayamk JS
معرفی وب سرویس ملی پیامک
ملی پیامک یک وب سرویس کامل برای ارسال و دریافت پیامک و پیامک صوتی و مدیریت کامل خدمات دیگر است که براحتی میتوانید از آن استفاده کنید.
نصب
قبل از نصب نیاز به ثبت نام در سایت ملی پیامک دارید.
پس ازثبت نام برای نصب از راههای زیر میتوانید اقدام کنید.
npm install melipayamak-api
یا از طریق اضافه کردن خط زیر به فایل package.json
"melipayamak-api": "*"
و سپس اجرای دستور
npm update
نحوه استفاده
نمونه کد برای ارسال پیامک
const MelipayamakApi = const username = 'username'; const password = 'password'; const api = usernamepassword; const sms = api; const to = '09123456789'; const from = '5000...'; const text = 'تست وب سرویس ملی پیامک'; sms
از آنجا که وب سرویس ملی پیامک تنها محدود به ارسال پیامک نیست شما از طریق زیر میتوانید به وب سرویس ها دسترسی کامل داشته باشید:
// وب سرویس پیامکconst smsRest = api;const smsSoap = api;// وب سرویس تیکت پشتیبانیconst ticket = api;// وب سرویس برای مدیریت کامل ارسال انبوه پیامکconst branch = api;//وب سرویس کاربرانconst users = api;//وب سرویس دفترچه تلفنconst contacts = api;
تفاوت های وب سرویس پیامک rest و soap
از آنجا که ملی پیامک وب سرویس کاملی رو در اختیار توسعه دهندگان میگزارد برای راحتی کار با وب سرویس پیامک علاوه بر وب سرویس اصلی soap وب سرویس rest رو هم در اختیار توسعه دهندگان گزاشته شده تا راحتتر بتوانند با وب سرویس کار کنند. تفاوت اصلی این دو در تعداد متد هاییست که میتوانید با آن کار کنید. برای کار های پایه میتوان از وب سرویس rest استفاده کرد برای دسترسی بیشتر و استفاده پیشرفته تر نیز باید از وب سرویس باید از وب سرویس soap استفاده کرد. جهت مطالعه بیشتر وب سرویس ها به قسمت وب سرویس پنل خود مراجعه کنید.
جهت آشنایی با پارامتر های ورودی و خروجی داکیومنت های وب سرویس در پنل خود را مطالعه کنید.
وب سرویس پیامک
متد های وب سرویس:
ارسال
smsRest;smsSoap;
- در وب سرویس soap به جای ارسال یک شماره آرایه ای از شماره ها نیز قابل قبول است
دریافت وضعیت ارسال
smsRest;smsSoap;
- به در وب سرویس soap به جای تک آیدی میتوان آرایه نیز ارسال کرد.
لیست پیامک ها
smsRest;smsSoap;smsSoap;// جهت دریافت به صورت رشته ایsmsSoap;//جهت دریافت بر اساس تاریخsmsSoap;// جهت دریافت پیام های کاربران بر اساس تاریخ
موجودی
smsRest;smsSoap;
تعرفه پایه / دریافت قیمت قبل از ارسال
smsRest;smsSoap;
لیست شماره اختصاصی
smsRest;
بررسی تعداد پیامک های دریافتی
smsSoap;//پیش فرض خوانده نشده
ارسال پیامک پیشرفته
smsSoap;
مشاهده مشخصات پیام
smsSoap;
حذف پیام دریافتی
smsSoap;
ارسال زماندار
smsSoap;
ارسال زماندار متناظر
smsSoap;
ارسال سررسید
smsSoap;
مشاهده وضعیت ارسال زماندار
smsSoap;
حذف پیامک زماندار
smsSoap;
ارسال پیامک همراه با تماس صوتی
smsSoap;
ارسال پیامک همراه با تماس صوتی به صورت زمانبندی
smsSoap;
دریافت وضعیت پیامک همراه با تماس صوتی
smsSoap;
وب سرویس ارسال انبوه/منطقه ای
دریافت شناسه شاخه های بانک شماره
branch;
اضافه کردن یک بانک شماره جدید
branch;
اضافه کردن شماره به بانک
branch;
حذف یک بانک
branch;
ارسال انبوه از طریق بانک
branch;branch;
تعداد شماره های موجود
branch;
گزارش گیری از ارسال انبوه
branch;
تعیین وضعیت ارسال
branch;
تعداد ارسال های امروز
branch;
تعداد ارسال های کل
branch;
حذف ارسال منطقه ای
branch;
ارسال متناظر
branch;
نمایش دهنده وضعیت گزارش گیری
branch;
وب سرویس تیکت
ثبت تیکت جدید
ticket;
جستجو و دریافت تیکت ها
ticket;
دریافت تعداد تیکت های کاربران
ticket;
دریافت تیکت های ارسال شده
ticket;
دریافت تعداد تیکت های ارسال شده
ticket;
پاسخگویی به تیکت
ticket;
وب سرویس دفترچه تلفن
اضافه کردن گروه جدید
contacts;
اضافه کردن کاربر جدید
contacts;
بررسی موجود بودن شماره در دفترچه تلفن
contacts;
دریافت اطلاعات دفترچه تلفن
contacts;
دریافت گروه ها
contacts;
ویرایش مخاطب
contacts;
حذف مخاطب
contacts;
دریافت اطلاعات مناسبت های فرد
contacts;
وب سرویس کاربران
ثبت فیش واریزی
users;
اضافه کردن کاربر جدید در سامانه
users;
اضافه کردن کاربر جدید در سامانه(کامل)
users;
اضافه کردن کاربر جدید در سامانه(WithLocation)
users;
بدست آوردن ID کاربر
users;
تغییر اعتبار
users;
فراموشی رمز عبور
users;
دریافت تعرفه پایه کاربر
users;
دریافت اعتبار کاربر
users;
دریافت مشخصات کاربر
users;
دریافت شماره های کاربر
users;
دریافت تراکنش های کاربر
users;
دریافت اطلاعات کاربران
users;
دریافت اطلاعات فیلترینگ
users;
حذف کاربر
users;
مشاهده استان ها
users;
مشاهده کد شهرستان
users;
مشاهده تاریخ انقضای کاربر
users;