Backend API
وب‌سرویس کاربران آزمایشی
علامت‌گذاری و رفع علامت مشترکین به‌عنوان کاربر آزمایشی از سمت سرور برای ارسال آزمایشی قبل از کمپین اصلی.
POST
https://pushfa.com/api/webservices/test-user/*
پیش‌نیاز: احراز هویت وب‌سرویس
تمام وب‌سرویس‌های این صفحه به کلید عمومی و خصوصی سرویس نیاز دارند. این کلیدها را از پنل (سرویس‌ها ← تنظیمات و جزئیات) دریافت کنید.
وب‌سرویس: علامت‌گذاری کاربر آزمایشی
POST
https://pushfa.com/api/webservices/test-user/set
علامت‌گذاری یک مشترک به‌عنوان کاربر آزمایشی از سمت سرور:
| پارامتر | مقدار | اجباری |
|---|---|---|
| api_public_key | کلید عمومی سرویس | بله |
| api_private_key | کلید خصوصی سرویس | بله |
| subscriber_id | شناسه ثابت مخاطب (Subscriber ID) دستگاه | بله |
curl -X POST https://pushfa.com/api/webservices/test-user/set \
-H "Content-Type: application/json" \
-d '{
"api_public_key": "YOUR_PUBLIC_KEY",
"api_private_key": "YOUR_PRIVATE_KEY",
"subscriber_id": "SUBSCRIBER_UUID"
}'وب‌سرویس: رفع علامت کاربر آزمایشی
POST
https://pushfa.com/api/webservices/test-user/unset
رفع علامت کاربر آزمایشی از یک مشترک از سمت سرور:
علامت‌گذاری کاربر آزمایشی فقط از پنل یا وب‌سرویس با کلید خصوصی ممکن است و از جاوااسکریپت سمت کاربر امکان‌پذیر نیست.
| پارامتر | مقدار | اجباری |
|---|---|---|
| api_public_key | کلید عمومی سرویس | بله |
| api_private_key | کلید خصوصی سرویس | بله |
| subscriber_id | شناسه ثابت مخاطب (Subscriber ID) دستگاه | بله |
curl -X POST https://pushfa.com/api/webservices/test-user/unset \
-H "Content-Type: application/json" \
-d '{
"api_public_key": "YOUR_PUBLIC_KEY",
"api_private_key": "YOUR_PRIVATE_KEY",
"subscriber_id": "SUBSCRIBER_UUID"
}'شناسه پایدار مخاطب و سازگاری با کلیدهای قدیمی
از subscriber_id برای یک مخاطب و subscriber_ids[] برای چند مخاطب استفاده کنید؛ این شناسه‌ها با چرخش توکن تغییر نمی‌کنند و پایدارترند. کلیدهای fcm_token و fcm_tokens[] به دلیل پایداری کمتر منسوخ شده‌اند، اما برای سازگاری همچنان پشتیبانی می‌شوند. ارسال هم‌زمان subscriber_id و fcm_token یا subscriber_ids و fcm_tokens، حتی با مقدار خالی، خطای اعتبارسنجی 422 می‌دهد.