استعلام وضعیت نوتیفیکیشن
بررسی وضعیت ارسال، تحویل و کلیک یک یا چند نوتیفیکیشن با استفاده از شناسه notification_id.
POST
https://pushfa.com/api/webservices/check-notification-status
کاربرد
پس از ارسال نوتیفیکیشن، notification_id دریافتی را نگه دارید و با این API وضعیت هر گیرنده را بررسی کنید.
شفافسازی وضعیتها و نحوه محاسبه هزینه
هزینه هر مرحله فقط پس از ثبت همان رویداد محاسبه میشود. وضعیت ناموفق با دریافتنشدن پیام توسط مشترک یکسان نیست و بر اساس پاسخ Firebase تعیین میشود.
اگر Firebase شناسه تأیید ارسال را صادر کند، پیام از جانب پوشفا «ارسالشده» محسوب میشود و هزینه ارسال کسر خواهد شد؛ حتی اگر مشترک در آن زمان به اینترنت دسترسی نداشته باشد یا به دلیل اختلالات شبکه پیام را دریافت نکند.
| وضعیت | معیار ثبت وضعیت | اثر مالی |
|---|---|---|
| ناموفق (failed) | Firebase توکن یا شناسه دستگاه را نامعتبر اعلام کند، یا به هر دلیل شناسه تأیید ارسال را صادر نکند. | هزینه ارسال بهصورت خودکار به اعتبار کاربر عودت داده میشود. |
| ارسالشده (sent) | Firebase شناسه تأیید ارسال را صادر کرده باشد. | هزینه ارسال مطابق تعرفه کسر میشود. |
| تحویلشده (delivered) | دستگاه یا مرورگر دریافت پیام را به پوشفا تأیید کند. | در صورت فعالبودن گزارش تحویل، هزینه تحویل مطابق تعرفه کسر میشود. |
| کلیکشده (clicked) | کلیک مشترک روی اعلان یا دکمه آن در پوشفا ثبت شود. | در صورت فعالبودن گزارش کلیک، هزینه کلیک مطابق تعرفه کسر میشود. |
پارامترهای ورودی
| پارامتر | مقدار | اجباری |
|---|---|---|
| api_public_key | کلید عمومی سرویس | بله |
| api_private_key | کلید خصوصی سرویس | بله |
| notification_ids[] | آرایهای از شناسههای نوتیفیکیشنهای ارسالی | بله |
نمونه درخواست
curl -X POST https://pushfa.com/api/webservices/check-notification-status \
-H "Content-Type: application/json" \
-d '{
"api_public_key": "YOUR_PUBLIC_KEY",
"api_private_key": "YOUR_PRIVATE_KEY",
"notification_ids": ["MESSAGE_ID_1", "MESSAGE_ID_2"]
}'