انتقل إلى المحتوى

فهرس مرجع أساليب API

توفر Pushwoosh مكتبة واسعة تضم أكثر من 100 أسلوب لواجهة برمجة التطبيقات (API)، مصنفة لوظائف مختلفة مثل إرسال الإشعارات وإدارة المستخدمين وتتبع التحليلات.

واجهة برمجة تطبيقات الرسائل (Messages API)

Anchor link to
createMessageينشئ إشعار دفع جديد.
deleteMessageيحذف رسالة مجدولة.
getMessageDetailsيسترجع تفاصيل الرسالة.
createTargetedMessageينشئ إشعار دفع مستهدفًا جديدًا للاستهداف المتقدم عبر تطبيقات متعددة.
getPushHistory مهملاستخدم /messages:list لاسترداد سجل الرسائل مع بيانات مفصلة.
cancelMessageيلغي رسالة مجدولة.

واجهة برمجة تطبيقات الإعدادات المسبقة (Presets API)

Anchor link to
createPresetينشئ إعدادًا مسبقًا جديدًا.
getPresetيسترجع معلمات إعداد الدفع المسبق المحدد.
listPresetsيسترجع قائمة بالإعدادات المسبقة التي تم إنشاؤها للتطبيق.
deletePresetيحذف إعدادًا مسبقًا من حسابك.

واجهة برمجة تطبيقات الأجهزة (Device API)

Anchor link to
registerDeviceيسجل جهازًا للتطبيق.
unregisterDeviceيزيل رمز الدفع الخاص بالجهاز.
setTagsيضبط قيم العلامات للجهاز.
getTagsيسترجع العلامات مع قيمها المقابلة لجهاز معين.
setBadgeيرسل قيمة الشارة الحالية لجهاز إلى Pushwoosh.
applicationOpenيسجل حدث فتح التطبيق.
pushStatيسجل حدث فتح إشعار الدفع.
messageDeliveryEventيسجل حدث تسليم إشعار الدفع للجهاز.

واجهة برمجة تطبيقات الجمهور (Audience API)

Anchor link to
bulkSetTagsيضبط قيم العلامات لأجهزة متعددة.
bulkSetTags Statusيعيد حالة عملية bulkSetTags.
bulkRegisterDeviceيسجل أجهزة متعددة في طلب واحد، بما في ذلك قيم العلامات الاختيارية لكل جهاز.
bulkRegisterDevice Statusيسترجع حالة ونتائج طلب تسجيل جهاز جماعي باستخدام معرف الطلب.
bulkUnregisterDeviceيلغي تسجيل أجهزة متعددة في طلب واحد.
bulkUnregisterDevice Statusيسترجع حالة ونتائج طلب إلغاء تسجيل جهاز جماعي باستخدام معرف الطلب.

واجهة برمجة تطبيقات العلامات (Tags API)

Anchor link to
addTagينشئ علامة في حسابك.
deleteTagيزيل علامة مع جميع المعلومات المرتبطة بها.
listTagsيسترجع قائمة بالعلامات الموجودة في الحساب.

واجهة برمجة تطبيقات التجزئة (الفلاتر) (Segmentation (Filters) API)

Anchor link to
createFilterينشئ شريحة جديدة.
listFiltersيعيد قائمة بالشرائح المتاحة مع شروطها.
deleteFilterيحذف شريحة موجودة.
exportSegmentيجدول طلبًا لتصدير المشتركين المطابقين لشروط الشريحة.
exportSegment Resultsيسترجع رابط CSV لنتائج exportSegment.

واجهة برمجة التطبيقات المتمحورة حول المستخدم (User-centric API)

Anchor link to
registerUserيربط معرف المستخدم الخارجي (User ID) بجهاز محدد.
postEventيستدعي الحدث داخل التطبيق.

واجهة برمجة تطبيقات الأحداث (Events API)

Anchor link to
createEventينشئ حدثًا للتطبيق.

واجهة برمجة تطبيقات التطبيقات (Applications API)

Anchor link to
createApplicationينشئ تطبيقًا جديدًا على الحساب.
updateApplicationيحدّث إعدادات التطبيق.
deleteApplicationيحذف التطبيق من الحساب.
getApplicationيحصل على تفاصيل حول التطبيق.
getApplicationsيسترجع قائمة بالتطبيقات الموجودة على الحساب.
getApplicationFileيسترجع ملفات التكوين المتعلقة بالتطبيق.
setApplicationPlatformStatusيغير حالة المنصة للتطبيق.

واجهة برمجة تطبيقات الحملات (Campaigns API)

Anchor link to
createCampaignينشئ حملة دفع جديدة.
deleteCampaignيحذف حملة معينة.
getCampaignsيسترجع قائمة بالحملات الخاصة بالتطبيق.

واجهة برمجة تطبيقات تكوين التطبيق (App configuration API)

Anchor link to
configureApplication for iOSيقوم بتكوين منصة iOS للتطبيق.
configureApplication for Androidيقوم بتكوين منصة Android للتطبيق.
configureApplication for Mac OS Xيقوم بتكوين منصة macOS للتطبيق.
configureApplication for Windowsيقوم بتكوين منصة Windows للتطبيق.
configureApplication for Amazonيقوم بتكوين منصة Amazon للتطبيق.
configureApplication for Chromeيقوم بتكوين منصة Chrome للتطبيق.
configureApplication for Safariيقوم بتكوين منصة Safari للتطبيق.
configureApplication for Firefoxيقوم بتكوين منصة Firefox للتطبيق.
configureApplication for Emailيقوم بتكوين منصة البريد الإلكتروني (Email) للتطبيق.

واجهة برمجة تطبيقات البريد الإلكتروني (Email API)

Anchor link to
createEmailMessageينشئ رسالة بريد إلكتروني.
registerEmailيسجل عنوان بريد إلكتروني للتطبيق.
deleteEmailيزيل عنوان بريد إلكتروني من قاعدة بياناتك.
setEmailTagsيضبط قيم العلامات لعنوان البريد الإلكتروني المحدد.
registerEmailUserيربط معرف مستخدم خارجي (User ID) بعنوان بريد إلكتروني محدد.

واجهة برمجة تطبيقات أجهزة الاختبار (Test devices API)

Anchor link to
createTestDeviceيسجل جهاز اختبار للتطبيق.
listTestDevicesيسترجع جميع أجهزة الاختبار المسجلة للتطبيق.

واجهة برمجة تطبيقات صندوق الوارد للرسائل (Message inbox API)

Anchor link to
getInboxMessagesيسترجع قائمة رسائل صندوق الوارد لـ HWID محدد.
inboxStatusيحدّث حالة رسالة صندوق وارد معينة.

واجهة برمجة تطبيقات الإحصائيات (Statistics API)

Anchor link to

إحصائيات الرسائل

Anchor link to
messages:listيسترجع قائمة بالرسائل المرسلة.
totalsByIntervalsيوفر مقاييس وبيانات تحويل مجمعة حسب الساعة.
getMessageLogيسترجع معلومات مفصلة حول الرسائل المرسلة.
linksInteractionsيوفر إحصائيات حول نقرات روابط البريد الإلكتروني.
linksInteractionsDevicesيسرد المستخدمين الذين نقروا على الروابط في رسائل البريد الإلكتروني.
bouncedEmailsيوفر معلومات حول ارتداد رسائل البريد الإلكتروني والشكاوى وأسباب الارتداد.

إحصائيات التطبيق والمشتركين

Anchor link to
getApplicationSubscribersStatsيسترجع إحصائيات مشتركي التطبيق، مجمعة حسب نوع الجهاز.
getAppStatsيسترجع إحصائيات التطبيق لفترة زمنية محددة.
getSubscribersStatisticsيسترجع إحصائيات المشتركين لفترة زمنية محددة.

إحصائيات الحملة

Anchor link to
getCampaignStatsيسترجع إحصائيات الحملة لفترة زمنية محددة.

إحصائيات الأحداث والعلامات

Anchor link to
getEventStatisticsيسترجع عدد المرات التي تم فيها تشغيل حدث خلال فترة محددة.
getTagStatsيسترجع إحصائيات لعلامة معينة.

واجهة برمجة تطبيقات أنشطة iOS المباشرة (iOS Live Activities API)

Anchor link to
startLiveActivityينشئ نشاطًا مباشرًا جديدًا على iOS.
updateLiveActivityيحدّث نشاطًا مباشرًا موجودًا على iOS.

واجهة برمجة تطبيقات رحلة العميل (Customer Journey API)

Anchor link to
Get Journey statsيحصل على إحصائيات لرحلة معينة من خلال معرفها (ID).
Remove users from journeysيزيل مستخدمًا واحدًا أو أكثر من جميع الرحلات النشطة أو من رحلات محددة.

واجهة برمجة تطبيقات الطلبات المجدولة (Scheduled requests API)

Anchor link to
getResultsيسترجع نتيجة طلب مجدول.

واجهة برمجة تطبيقات الرسائل القصيرة (SMS API)

Anchor link to
createSMSMessageينشئ رسالة SMS جديدة.

واجهة برمجة تطبيقات واتساب (WhatsApp API)

Anchor link to
createWhatsAppMessageينشئ رسالة واتساب جديدة.

واجهة برمجة تطبيقات LINE (LINE API)

Anchor link to
createLineMessageينشئ رسالة LINE جديدة.

واجهة برمجة تطبيقات Kakao (Kakao API)

Anchor link to
createKakaoMessageيرسل رسالة Kakao باستخدام قالب معتمد.

واجهة برمجة تطبيقات المناطق الجغرافية (Geozones API)

Anchor link to
getNearestZoneيسترجع معلمات أقرب منطقة جغرافية والمسافة إليها. يسجل أيضًا موقع الجهاز لإشعارات الدفع الجغرافية.
addGeoZoneيضيف منطقة جغرافية (Geozone) إلى تطبيق معين.
updateGeoZoneيحدّث خصائص المنطقة الجغرافية مثل الاسم والحالة والمحتوى والنطاق.
deleteGeoZoneيزيل المناطق الجغرافية من التطبيق.
addGeoZoneClusterيضيف مجموعة مناطق جغرافية (Geozone Cluster) إلى التطبيق.
deleteGeoZoneClusterيزيل مجموعة مناطق جغرافية من التطبيق.
listGeoZonesيسترجع قائمة بالمناطق الجغرافية للتطبيق.
listGeoZoneClustersيسترجع قائمة بمجموعات المناطق الجغرافية للتطبيق.