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

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

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

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

Anchor link to
createMessageتنشئ إشعار دفع جديد.
deleteMessageتحذف رسالة مجدولة.
getMessageDetailsتسترجع تفاصيل الرسالة.
createTargetedMessageتنشئ إشعار دفع مستهدف جديد للاستهداف المتقدم عبر تطبيقات متعددة.
getPushHistoryتحصل على سجل الرسائل مع تفاصيل الدفع.
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تسترجع قائمة رسائل صندوق الوارد (Inbox) لمعرف جهاز (HWID) محدد.
inboxStatusتحدث حالة رسالة صندوق وارد (Inbox) معينة.

واجهة برمجة تطبيقات الإحصائيات (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تنشئ رسالة WhatsApp جديدة.

واجهة برمجة تطبيقات 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تحدث خصائص المنطقة الجغرافية (Geozone) مثل الاسم والحالة والمحتوى والنطاق.
deleteGeoZoneتزيل المناطق الجغرافية (Geozones) من التطبيق.
addGeoZoneClusterتضيف مجموعة مناطق جغرافية (Geozone Cluster) إلى التطبيق.
deleteGeoZoneClusterتزيل مجموعة مناطق جغرافية (Geozone Cluster) من التطبيق.
listGeoZonesتسترجع قائمة بالمناطق الجغرافية (Geozones) للتطبيق.
listGeoZoneClustersتسترجع قائمة بمجموعات المناطق الجغرافية (Geozone clusters) للتطبيق.