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

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

واجهة برمجة تطبيقات المراسلة v2

واجهة برمجة تطبيقات موحدة تحل محل عائلة /create*Message بأكملها (push, email, SMS, Kakao). انظر النظرة العامة ودليل الترحيل.

Notify	ينشئ ويرسل رسالة واحدة عبر أي قناة. يحل محل /createMessage، /createTargetedMessage، /createEmailMessage، /createSMSMessage، /createKakaoMessage.

بوابة SMTP

أرسل البريد الإلكتروني للمعاملات عبر بروتوكول SMTP القياسي بدلاً من استدعاء واجهة برمجة التطبيقات مباشرة. تقوم البوابة بالمصادقة باستخدام رمز التطبيق الخاص بك ورمز API، ثم تعيد توجيه كل رسالة إلى Notify. انظر مرجع بوابة SMTP.

واجهة برمجة تطبيقات الرسائل

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

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

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

واجهة برمجة تطبيقات الجهاز

registerDevice	يسجل جهازًا للتطبيق.
unregisterDevice	يزيل رمز الدفع الخاص بالجهاز.
deleteDevice	يحذف جهازًا وجميع بياناته المرتبطة في التطبيق المحدد.
setTags	يضبط قيم العلامات (Tags) للجهاز.
getTags	يسترجع العلامات (Tags) مع قيمها المقابلة لجهاز معين.
setBadge	يرسل قيمة الشارة (badge) الحالية لجهاز إلى Pushwoosh.
applicationOpen	يسجل حدث فتح التطبيق.
pushStat	يسجل حدث فتح إشعار الدفع.
messageDeliveryEvent	يسجل حدث تسليم إشعار الدفع للجهاز.

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

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

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

addTag	ينشئ علامة (Tag) في حسابك.
deleteTag	يزيل علامة (Tag) مع جميع المعلومات المرتبطة بها.
listTags	يسترجع قائمة بالعلامات (Tags) في الحساب.

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

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

واجهة برمجة التطبيقات المتمحورة حول المستخدم

registerUser	يربط معرف المستخدم الخارجي (User ID) بجهاز محدد.
deleteUser	يحذف مستخدمًا وجميع الأجهزة المرتبطة بمعرف المستخدم (User ID) المحدد.
postEvent	يستدعي الحدث (event) داخل التطبيق.

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

createEvent	ينشئ حدثًا (event) للتطبيق.

واجهة برمجة تطبيقات التطبيقات

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

واجهة برمجة تطبيقات الحملات

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

واجهة برمجة تطبيقات تكوين التطبيق

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) للتطبيق.

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

createEmailMessage مهمل	ينشئ رسالة بريد إلكتروني. استخدم Notify مع platforms: ["EMAIL"] وemail_payload بدلاً من ذلك.
registerEmail	يسجل عنوان بريد إلكتروني للتطبيق.
deleteEmail	يزيل عنوان بريد إلكتروني من قاعدة بياناتك.
setEmailTags	يضبط قيم العلامات (Tags) لعنوان البريد الإلكتروني المحدد.
registerEmailUser	يربط معرف مستخدم خارجي (User ID) بعنوان بريد إلكتروني محدد.

واجهة برمجة تطبيقات أجهزة الاختبار

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

واجهة برمجة تطبيقات صندوق الوارد للرسائل

getInboxMessages	يسترجع قائمة رسائل صندوق الوارد (Inbox) لمعرف HWID محدد.
inboxStatus	يحدّث حالة رسالة صندوق وارد (Inbox) معينة.

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

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

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

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

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

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

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

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

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

واجهة برمجة تطبيقات أنشطة iOS الحية

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

واجهة برمجة تطبيقات Apple Wallet PassKit

Apple Wallet PassKit API	مرجع لإدارة بطاقات Apple Wallet والتكوينات ذات الصلة في Pushwoosh.

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

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

واجهة برمجة تطبيقات الطلبات المجدولة

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

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

createSMSMessage مهمل	ينشئ رسالة SMS جديدة. استخدم Notify مع platforms: ["SMS"] بدلاً من ذلك.

واجهة برمجة تطبيقات WhatsApp

createWhatsAppMessage مهمل	ينشئ رسالة WhatsApp جديدة. استخدم Notify مع platforms: ["WHATS_APP"] بدلاً من ذلك.

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

createLineMessage مهمل	ينشئ رسالة LINE جديدة. استخدم Notify مع platforms: ["LINE"] بدلاً من ذلك.

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

createKakaoMessage مهمل	يرسل رسالة Kakao باستخدام قالب معتمد. استخدم Notify مع platforms: ["KAKAO"] بدلاً من ذلك.

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

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