در مطلب قبل در مورد وب-سرویس-نجوا توضیح دادیم در این مطلب در مورد ارسال پوش نوتیفیکیشن با API نجوا توضیح خواهیم داد:
توضیحات اولیه
API های نجوا، مجموعه ای از API های کارا و راحت برای استفاده است(ارسال پوش نوتیفیکیشن با API نجوا). که شما میتوانید به کمک آنها اطلاعات حساب خود در نجوا (از قبیل شناسه سگمنتها و …) را دریافت نمایید و میتوانید به صورت برنامهنویسی شده اقدام به ارسال نوتیفیکیشن برای کاربران وبسایت یا اپلیکیشن خود کنید
توجه:
تمامی APIهای نجوا باید از سمت سرور صدا زده شوند. به دلیل این که تمامی این API ها token-base هستند، الزامی است که از سمت سرور API ها صدا زده شوند
دریافت توکن برای احراز هویت:
در نجوا به هر فرستنده یک token اختصاص داده شده است. و سیستم نجوا از جمله APIهای آن کاربر را تنها از طریق این token میشناسند. لذا ضروری است که این token را از قسمت مشخصات APIدر پنل کاربری خود دریافت نمایید. همچنین در این صفحه برای هر یک از وبسایتها یا اپلیکیشنهای شما یک api-key نوشته شده است. که این api-key همان شناسه یکتای وبسایت شماست و در توضیح API ها که در زیر آمده است هر جا api-keyآمده است منظور همینی است که در صفحه ی مشخصات API موجود است.
API ارسال نوتیفیکیشن برای اعضای یک وبسایت یا اپلیکیشن
توضیحات:
از این API برای ارسال نوتیفیکیشن برای تمامی اعضای یک وبسایت یا اپلیکیشن خود میتوانید استفاده کنید. در این APIمیتوانید کاربران خود را با توجه به سگمنتهایی که در پنل نجوای خود ساختهاید، فیلتر کنید. همچنین میتوانید کاربران اکانت onesignalخود را که در پنل نجوا وارد کردهاید نیز به جمع دریافتکنندگان نوتیفیکیشن ارسالی اضافه کنید
مثال:
در زیر یک نمونه ورودی و خروجی این API آورده شده است:
با توجه به این که به چه صورت API را صدا زده باشید یکی از حالت های زیر اتفاق میافتد:
تمامی فیلدهایی که به عنوان ورودی به API داده میشود در جدول زیر به صورت کامل توضیح داده شده است:
در این مقاله در موردارسال پوش نوتیفیکیشن با API نجوا توضیح دادیم در مقاله بعد در مورد کاربردapi در نجوا توضیح میدهیم.