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

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

createApplication

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

ينشئ تطبيقًا جديدًا على الحساب.

نص الطلب

الاسم	النوع	الوصف
authorize_all_tokens	boolean	يسمح لجميع رموز API بالتواصل مع هذا التطبيق.
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
icon	string	محتوى ثنائي مشفر بـ Base64 لملف png.
sdk_ios	string	نوع iOS SDK. القيم الممكنة: “pw” أو “corona”. بالنسبة لـ Corona، حمولة الدفع مختلفة.
sdk_android	string	نوع Android SDK. القيم الممكنة: “pw”، “corona”، “phonegap”. يختار مستخدمو AppPresser “phonegap”.
title*	string	عنوان للتطبيق الجديد في Pushwoosh.

مثال على الاستجابة:

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "application": "1DC69-73EDB"
  }
}

مثال على الكود:

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",          // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "icon": "iVBORw0KGgoAAAANSUhEUgAAA...",  // اختياري. محتوى ثنائي مشفر بـ Base-64 لملف png
    "authorize_all_tokens": true,            // اختياري. إذا كانت القيمة true، يسمح لجميع رموز api بالتواصل مع هذا التطبيق
    "sdk_ios": "pw",                         // اختياري. القيم الممكنة هي "pw" أو "corona"
    "sdk_android": "pw",                     // اختياري. القيم الممكنة هي "pw"، "corona"، أو "phonegap"
    "title": "APP_TITLE"                     // مطلوب. عنوان للتطبيق الجديد في Pushwoosh
  }
}

updateApplication

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

يحدّث إعدادات التطبيق.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh
icon	string	محتوى ثنائي مشفر بـ Base64 لملف png.
sdk_ios	string	نوع iOS SDK. القيم الممكنة: “pw” أو “corona”. بالنسبة لـ Corona، حمولة الدفع مختلفة.
sdk_android	string	نوع Android SDK. القيم الممكنة: “pw”، “corona”، “phonegap”. يختار مستخدمو AppPresser “phonegap”.
title	string	عنوان جديد للتطبيق في Pushwoosh.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

مثال

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",     // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",       // مطلوب. رمز التطبيق الذي تريد تحديثه
    "icon": "iVBORw0KGgoAAAANSUD6...",  // اختياري. محتوى ثنائي مشفر بـ Base-64 لملف png
    "sdk_ios": "pw",                    // اختياري. القيم الممكنة هي "pw" أو "corona"
    "sdk_android": "pw",                // اختياري. القيم الممكنة هي "pw"، "corona"، أو "phonegap"
    "title": "APP_TITLE"                // اختياري. عنوان جديد للتطبيق في Pushwoosh
  }
}

deleteApplication

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

يحذف التطبيق من الحساب.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

مثال

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX"    // مطلوب. رمز تطبيق Pushwoosh
  }
}

getApplication

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

يحصل على تفاصيل حول التطبيق.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "application": {
      "adm_cid": "",
      "adm_secret": "",
      "android_api_type": "x31",
      "android_gcm_api_key": "x7836363631366236353566366236353739",
      "android_sdk": "x7077",
      "icon_url": null,
      "ios_gateway": "x783330",
      "ios_key_management_type": "x783631373537343666",
      "ios_key_password": "x7836353336363236353335333736353333",
      "ios_sdk": "x7077",
      "title": "0 Application For test",
      "providers": {
        "ios": true,
        "amazon": false,
        "android": false,
        "chrome": false,
        "email": false,
        "firefox": false,
        "huawei_android": false,
        "internet_explorer": false,
        "osx": false,
        "safari": false,
        "sms": false,
        "web": false,
        "whats_app": false,
        "windows": false
      },
      "languages": {
        "en": "34",
        "zh": "12",
        "sv": "7",
        "de": "6",
        "pt": "6"
      }
    }
  }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // مطلوب رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX"    // مطلوب. رمز تطبيق Pushwoosh
  }
}

getApplications

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

يحصل على قائمة التطبيقات في الحساب. يمكن أن يعيد النتيجة مع ترقيم الصفحات.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
page	integer	رقم الصفحة لترقيم الصفحات.

مثال على الطلب

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "page": 2                        // اختياري. رقم الصفحة لترقيم الصفحات
  }
}

الاستجابة

إذا كان هناك أكثر من 100 تطبيق في الحساب، فإن الاستجابة تتضمن current page و total amount of pages.

مثال على الاستجابة

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "page": 1,   // الصفحة الحالية
    "total": 2,  // العدد الإجمالي للصفحات
    "applications": [{
      "APPLICATION_CODE": "MyApp1"
    }, {
      "APPLICATION_CODE": "MyApp2"
    }]
  }
}

getApplicationFile

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

يحصل على ملفات التكوين المتعلقة بالتطبيق.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh
file*	string	معرف الملف المراد استرداده. انظر القيم أدناه.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

مثال

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",    // مطلوب. رمز تطبيق Pushwoosh
    "file": "ios_auto_privatekey"    // مطلوب. معرف الملف المراد استرداده. انظر القيم أدناه
  }
}

القيم الممكنة لمعامل “file”:

`“ios_auto_privatekey” | “ios_manual_privatekey” | “ios_auto_certificate” | “ios_manual_certificate” | “ios_push_certificate” | “ios_provisioning_profile” | “macos_manual_privatekey” | “macos_manual_certificate” | “macos_push_certificate” | “safari_manual_privatekey” | “safari_push_certificate” | “safari_push_package” |

مثال على الاستجابة:

-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----

setApplicationPlatformStatus

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

يغير حالة منصة التطبيق.

نص الطلب

الاسم	النوع	الوصف
auth*	string	رمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*	string	رمز تطبيق Pushwoosh
platform*	integer	نوع المنصة. انظر قائمة أنواع المنصات أدناه.
status*	string	”تمكين” أو “تعطيل”

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "message": "iOS pushes are disabled",
    "available_platforms": {
      "iOS": false,
      "Android": true,
      "OS X": false,
      "Windows": false,
      "Amazon": false,
      "Safari": false,
      "Chrome": true,
      "Firefox": false,
    }
  }
}

مثال

{
  "request": {
    "application": "XXXXX-XXXXX",   // مطلوب. رمز تطبيق Pushwoosh
    "auth": "yxoPUlwqm…………pIyEX4H", // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "platform": 1,                  // مطلوب. 1 — iOS; 3 — Android; 7 — Mac OS X; 8 — Windows;
                                    //           9 — Amazon; 10 — Safari; 11 — Chrome; 12 — Firefox;
    "status": "disable"             // مطلوب. "تعطيل" أو "تمكين"
  }
}