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

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

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

تُنشئ علامة في حسابك.

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول لواجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
tag*objectمعلمات العلامة.
tag.name*stringاسم العلامة.
tag.type*integerنوع العلامة. انظر القيم الممكنة أدناه.
tag.user_specificbooleanعندما تكون القيمة true، يتم تخزين قيمة العلامة على مستوى المستخدم ومشاركتها عبر جميع أجهزة المستخدم عند تعيينها بواسطة UserID. عندما تكون القيمة false (الافتراضي)، تكون العلامة على مستوى الجهاز ويتم تعيينها لكل HWID.
{
"status_code": 200,
"status_message": "OK",
"response": {
"result": true
}
}
مثال
{
"request": {
"auth": "yxoPUlwqm…………pIyEX4H", // مطلوب. رمز الوصول لواجهة برمجة التطبيقات من لوحة تحكم Pushwoosh
"tag": {
"name": "TAG_NAME", // مطلوب.
"type": 1, // مطلوب. انظر القيم الممكنة أدناه
"user_specific": false // اختياري. true = علامة على مستوى المستخدم (مشتركة عبر جميع الأجهزة)؛ false = علامة على مستوى الجهاز (الافتراضي)
}
}
}

أنواع قيم العلامات الممكنة:

  • 1 - عدد صحيح
  • 2 - سلسلة نصية
  • 3 - قائمة
  • 4 - تاريخ
  • 5 - قيمة منطقية
  • 6 - عشري. مثال: 19.95
  • 7 - إصدار. مثال: “1.0.0.0”

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

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول لواجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
tag*objectمعلمات العلامة.
tag.name*stringاسم العلامة (tag) المراد حذفها.
{
"status_code": 200,
"status_message": "OK",
"response": {
"result": true
}
}
مثال
{
"request": {
"auth": "yxoPUlwqm…………pIyEX4H", // مطلوب. رمز الوصول لواجهة برمجة التطبيقات من لوحة تحكم Pushwoosh
"tag": {
"name": "TAG_NAME" // مطلوب. اسم العلامة المراد حذفها
}
}
}

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

تسترد قائمة بالعلامات الموجودة في الحساب.

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول لواجهة برمجة التطبيقات (API access token) من لوحة تحكم Pushwoosh.
{
"status_code": 200,
"status_message": "OK",
"response": {
"tags": [{
"name":"Language",
"type":2
}, {
"name":"List tag",
"type":3
}]
}
}
مثال
{
"request":{
"auth": "yxoPUlwqm…………pIyEX4H" // رمز الوصول لواجهة برمجة التطبيقات من لوحة تحكم Pushwoosh
}
}

أنواع العلامات:

  • 1 - عدد صحيح
  • 2 - سلسلة نصية
  • 3 - قائمة
  • 4 - تاريخ
  • 5 - قيمة منطقية
  • 6 - عشري. مثال: 19.95
  • 7 - إصدار. مثال: “1.0.0.0”