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

تُنشئ واجهة برمجة تطبيقات الأحداث حدثًا في تطبيق Pushwoosh مع وصفه وسماته. إنشاء الحدث مسبقًا أمر اختياري. استخدمها عندما تريد تعيين أنواع السمات بنفسك، لأن /postEvent يُنشئ الحدث غير الموجود تلقائيًا ويكتشف أنواع السمات من القيم التي يتلقاها.

createEvent

POST https://api.pushwoosh.com/json/1.3/createEvent

ينشئ حدثًا للتطبيق.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى واجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh
name	string	اسم الحدث, 128 حرفًا كحد أقصى.
description	string	وصف الحدث, 512 حرفًا كحد أقصى.
eventAttributes	array	مصفوفة سمات الحدث.
trackRevenue	boolean	انظر قسم تتبع إيرادات الحدث.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "event": 351 // معرف الحدث الذي تم إنشاؤه
  }
}

{
  "request": {
    "auth":"yxoPUlwqm…………pIyEX4H",     // مطلوب. رمز الوصول إلى واجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",      // مطلوب. رمز تطبيق Pushwoosh
    "name": "BasketOpen",              // مطلوب. 128 حرفًا كحد أقصى. اسم الحدث.
    "description": "Open basket page", // اختياري. 512 حرفًا كحد أقصى. وصف الحدث.
    "eventAttributes": [{              // اختياري. مصفوفة سمات الحدث
      "type": 3,                       // نوع السمة. القيم:
                                       // 1 - عدد صحيح (integer);
                                       // 2 - سلسلة نصية (string);
                                       // 3 - قائمة (list);
                                       // 4 - تاريخ (date);
                                       // 5 - قيمة منطقية (boolean);
                                       // 6 - سعر (price);
      "name": "products"               // 255 حرفًا كحد أقصى. اسم السمة
    }, {
      "type": 5,
      "name": "delivery"
    }],
    "trackRevenue": false
  }
}

الاستجابة:


200	200	تم إنشاء الحدث بنجاح
200	210	خطأ في الوسيطة. انظر status_message لمزيد من المعلومات
200	403	خطأ في الأذونات (على سبيل المثال, عند تجاوز حد الأحداث)
200	404	المورد غير موجود
400	N/A	سلسلة الطلب غير منسقة
500	500	خطأ داخلي