ارسال با Subscriber ID
ارسال پوش نوتیفیکیشن با شناسه ثابت مشترک — پایدارتر از توکن FCM، حتی پس از تجدید توکن معتبر است.
POST
https://pushfa.com/api/webservices/send-via-subscriber-id
کاربرد
Subscriber ID برخلاف توکن FCM در طول زمان ثابت میماند. پس از دریافت و ذخیره آن روی کاربرتان، از این API برای ارسال پایدار استفاده کنید.
Subscriber ID را با window.Pushfa.getSubscriberId() یا از پنل (سرویسها ← مشترکین) دریافت کنید.
پارامترهای ورودی
| پارامتر | مقدار | اجباری |
|---|---|---|
| subscriber_ids[] | آرایهای از Subscriber IDهای مقصد | بله |
| device | محدودیت دستگاه: all، mobile یا desktop | خیر |
| api_public_key | کلید عمومی سرویس پوشفا | بله |
| api_private_key | کلید خصوصی سرویس پوشفا | بله |
| title | عنوان پوش نوتیفیکیشن | بله |
| body | متن اصلی پوش نوتیفیکیشن | بله |
| link_url | لینک مقصد پس از کلیک روی نوتیفیکیشن (مثال: https://example.com) | خیر |
| image_url | آدرس تصویر ضمیمه نوتیفیکیشن | خیر |
| get_delivery_status | درخواست گزارش تحویل (مقدار 1/0 در ارسال تکی یا true/false در ارسال گروهی) | خیر |
| webhook_url | آدرس وبهوک بومرنگ — در صورت عدم تحویل، نتیجه به این آدرس ارسال میشود | خیر |
| get_click_status | درخواست گزارش کلیک (مقدار 1/0 در ارسال تکی یا true/false در ارسال گروهی) | خیر |
| sendTime | زمان ارسال؛ مقدار current برای ارسال فوری و delay برای زمانبندیشده | بله |
| time | زمان ارسال با فرمت Y-m-d H:i — فقط اگر sendTime برابر delay باشد | اجباری اگر sendTime = delay |
| ttl | عمر نوتیفیکیشن به ثانیه (پیشفرض 86400 = 24 ساعت) | خیر |
نمونه درخواست
curl -X POST https://pushfa.com/api/webservices/send-via-subscriber-id \
-H "Content-Type: application/json" \
-d '{
"api_public_key": "YOUR_PUBLIC_KEY",
"api_private_key": "YOUR_PRIVATE_KEY",
"subscriber_ids": ["8f3c…", "a91b…"],
"title": "عنوان پیام",
"body": "متن پیام",
"sendTime": "current"
}'