انتقل إلى المحتوى
أدلة المستخدمالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

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

configureApplication لنظام iOS

Anchor link to

يقوم بتكوين منصة iOS للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
authstringرمز الوصول إلى API من لوحة تحكم Pushwoosh
applicationstringرمز تطبيق Pushwoosh
device_typeintegerيجب أن يكون 1 لنظام iOS
ios_key_management_typestring”manual”
ios_key_filestringمحتوى ملف مفتاح iOS المشفر بـ Base64
ios_key_passwordstringكلمة المرور لملف مفتاح iOS
ios_gatewayinteger”0” للبيئة التجريبية (sandbox)، “1” للإنتاج
ios_frameworkstringالقيم الممكنة: “native”, “cordova”, “titanium”
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": true,
      "amazon": false,
      "android": false,
      "baidu_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
    }
  }
}
مثال
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",      // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",        // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 1,                    // مطلوب. 1 لنظام iOS
    "ios_key_management_type": "manual", // مطلوب. "manual"
    "ios_key_file": "MIIMY...BAQ==",     // مطلوب. محتوى ملف مفتاح iOS المشفر بـ base64
    "ios_key_password": "password",      // مطلوب.
    "ios_gateway": 1,                    // مطلوب. "0" (sandbox) | "1" (production)
    "ios_framework": "native"            // مطلوب. القيم الممكنة: "native", "cordova", "titanium",
                                         //           "marmalade", "adobeAir", "corona", "xamarin",
                                         //           "phoneGapBuild", "triggerIO", "unity"
  }
}

configureApplication لنظام Android

Anchor link to

يقوم بتكوين منصة Android للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh الخاصة بك.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 3 لنظام Android.
android_framework*stringإطار عمل Android. القيم الممكنة: native, cordova, marmalade, adobeAir, corona, xamarin, phoneGapBuild, triggerIO, titanium, unity.
android_fcm_service_account*objectمفتاح حساب خدمة FCM (ملف JSON تم إنشاؤه في إعدادات مشروع Firebase).
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": true,
      "baidu_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
    }
  }
}
 
{
  "request": {
    "auth": "Z2PLR....IRwTqHwCr",
    "application": "87E33-XXXXX",
    "device_type": 3,
    "android_fcm_service_account": {
      "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
      "auth_uri": "https://accounts.google.com/o/oauth2/auth",
      "client_email": "****@foobar.iam.gserviceaccount.com",
      "client_id": "115********6584854983",
      "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-zffgu%40foobar.iam.gserviceaccount.com",
      "private_key": "-----BEGIN PRIVATE KEY-----\nuH/OU/fIL+i6Wm8as...\n-----END PRIVATE KEY-----\n",
      "private_key_id": "e3749********6d9",
      "project_id": "app-android",
      "token_uri": "https://oauth2.googleapis.com/token",
      "type": "service_account",
      "universe_domain": "googleapis.com"
    },
    "android_framework": "native"
  }
}

configureApplication لنظام Mac OS X

Anchor link to

يقوم بتكوين منصة Mac OS X للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 7 لنظام Mac OS X.
macos_key_management_type*stringالنوع “manual” فقط هو المتاح حاليًا.
macos_cert_filestringمحتوى ملف شهادة Mac OS X المشفر بـ Base64.
macos_key_filestringمحتوى ملف مفتاح Mac OS X المشفر بـ Base64.
macos_key_passwordstringكلمة مرور ملف المفتاح.
macos_gateway*integerبوابة الإشعارات. “0” للبيئة التجريبية (sandbox)، “1” للإنتاج.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_android": false,
      "chrome": false,
      "email": false,
      "firefox": false,
      "huawei_android": false,
      "internet_explorer": false,
      "osx": true,
      "safari": false,
      "sms": false,
      "web": false,
      "whats_app": false,
      "windows": false
    }
  }
}
مثال
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",                   // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",                     // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 7,                                 // مطلوب. 7 لنظام Mac OS X
    "macos_key_management_type": "manual",            // مطلوب. "manual"
    "macos_cert_file": "iVBORw0KGgoAAAANSUhEUgAABB…", // اختياري. محتوى ملف شهادة Mac OS X المشفر بـ Base64
    "macos_key_file": "iVBORw0KGgoAAAANSUhEUgAABB…",  // اختياري. محتوى ملف مفتاح Mac OS X المشفر بـ Base64
    "macos_key_password": "PASSWORD",                 // اختياري. كلمة مرور ملف المفتاح
    "macos_gateway": 1                                // مطلوب. بوابة الإشعارات. "0" للبيئة التجريبية (sandbox) أو "1" للإنتاج
  }
}

configureApplication لنظام Windows

Anchor link to

يقوم بتكوين منصات Windows للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 8 لنظام Windows.
wns_psid*stringمعرف أمان الحزمة من متجر Windows للتطبيق. يبدأ بـ “ms-app://“.
wns_secret*stringسر العميل (Client Secret) من متجر Windows للتطبيق.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_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": true
    }
  }
}
مثال
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",    // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 8,                // مطلوب. 8 لنظام Windows
    "wns_psid": "ms-app://…",        // مطلوب. معرف أمان الحزمة للتطبيق من متجر Windows
    "wns_secret": "CLIENT_SECRET"    // مطلوب. سر عميل Windows
  }
}

configureApplication لمنصة Amazon

Anchor link to

يقوم بتكوين منصة Amazon للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 9 لمنصة Amazon.
adm_cid*stringمعرف عميل Amazon.
adm_secret*stringسر عميل Amazon.
adm_framework*stringإطار عمل Amazon. القيم الممكنة: native, unity, adobeAir.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": true,
      "android": false,
      "baidu_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
    }
  }
}
مثال
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",  // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",    // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 9,                // مطلوب. 9 لمنصة Amazon
    "adm_cid": "CLIENT_ID",          // مطلوب. معرف عميل Amazon
    "adm_secret": "CLIENT_SECRET",   // مطلوب. سر عميل Amazon
    "adm_framework": "native"        // مطلوب. القيم الممكنة: native, unity, adobeAir.
  }
}

configureApplication لمتصفح Chrome

Anchor link to

يقوم بتكوين منصة Chrome للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصفمطلوب
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.مطلوب
application*stringرمز تطبيق Pushwooshمطلوب
device_type*integerيجب أن يكون 11 لمتصفح Chrome.مطلوب
chrome_fcm_service_account*objectمفتاح حساب خدمة FCM (ملف JSON تم إنشاؤه في إعدادات مشروع Firebase).مطلوب
chrome_vapid_key*stringمفتاح VAPID العام (Voluntary Application Server Identification) المستخدم لمصادقة الإشعارات الفورية في Chrome.مطلوب
chrome_vapid_private_key*stringمفتاح VAPID الخاص المستخدم لتوقيع وإرسال الإشعارات الفورية في Chrome.مطلوب
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_android": false,
      "chrome": true,
      "email": false,
      "firefox": false,
      "huawei_android": false,
      "internet_explorer": false,
      "osx": false,
      "safari": false,
      "sms": false,
      "web": false,
      "whats_app": false,
      "windows": false
    }
  }
}
{
  "request": {
    "auth": "Z2PLR....IRwTqHwCr",
    "application": "87E33-XXXXX",
    "device_type": 11,
    "chrome_fcm_service_account": {
      "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
      "auth_uri": "https://accounts.google.com/o/oauth2/auth",
      "client_email": "****@foobar.iam.gserviceaccount.com",
      "client_id": "11529......6584854983",
      "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/****foobar.iam.gserviceaccount.com",
      "private_key": "-----BEGIN PRIVATE KEY-----\nuH/OU/fIm8as...\n-----END PRIVATE KEY-----\n",
      "private_key_id": "e3749......e66d9",
      "project_id": "app-chrome",
      "token_uri": "https://oauth2.googleapis.com/token",
      "type": "service_account",
      "universe_domain": "googleapis.com"
    },
    "chrome_vapid_key": "BEr....KPqQvCbU",
    "chrome_vapid_private_key": "ee....flOqmSo"
  }
}

configureApplication لمتصفح Safari

Anchor link to

يقوم بتكوين منصة Safari للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 10 لمتصفح Safari.
safari_key_management_type*stringالنوع “manual” فقط هو المتاح حاليًا.
safari_website_namestringاسم موقع الويب.
safari_allowed_domainsarrayمثال: https://site1.com”, https://site2.com”
safari_url_template*stringقالب URL لمتصفح Safari بالتنسيق “https://%@“.
safari_icon_filestringمحتوى ملف png بحجم 256x256 بكسل مشفر بـ Base64.
safari_key_file*stringمحتوى ملف مفتاح Safari .p12 المشفر بـ Base64.
safari_key_passwordstringكلمة المرور لملف المفتاح.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_android": false,
      "chrome": false,
      "email": false,
      "firefox": false,
      "huawei_android": false,
      "internet_explorer": false,
      "osx": false,
      "safari": true,
      "sms": false,
      "web": false,
      "whats_app": false,
      "windows": false
    }
  }
}
مثال
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",                    // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",                      // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 10,                                 // مطلوب. 10 لمتصفح Safari
    "safari_key_management_type": "manual",            // مطلوب. "manual"
    "safari_website_name": "WEBSITE_NAME",             // اختياري.
    "safari_allowed_domains": [                        // اختياري.
      "https://site1.com",
      "https://site2.com"
    ],
    "safari_url_template": "https://%@",               // مطلوب.
    "safari_icon_file": "iVBORw0KGgoAAAANSUhEUgAABB…", // اختياري. محتوى ملف png بحجم 256x256 بكسل مشفر بـ Base64
    "safari_key_file": "MIIMY...BAQ==",                // مطلوب. محتوى ملف مفتاح Safari .p12 المشفر بـ base64
    "safari_key_password": "PASSWORD"                  // اختياري. كلمة المرور لملف المفتاح أعلاه
  }
}

configureApplication لمتصفح Firefox

Anchor link to

يقوم بتكوين منصة Firefox للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصفمطلوب
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.مطلوب
application*stringرمز تطبيق Pushwooshمطلوب
device_type*integerيجب أن يكون 12 لمتصفح Firefox.مطلوب
firefox_is_enabledbooleanيفعل الإشعارات الفورية لمتصفح Firefox.اختياري
firefox_fcm_service_account*objectملف JSON تم إنشاؤه في إعدادات مشروع Firebase.مطلوب
firefox_vapid_key*stringمفتاح VAPID العام (Voluntary Application Server Identification) المستخدم لمصادقة الإشعارات الفورية في Firefox.مطلوب
firefox_vapid_private_key*stringمفتاح VAPID الخاص المستخدم لتوقيع وإرسال الإشعارات الفورية في Firefox.مطلوب
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_android": false,
      "chrome": false,
      "email": false,
      "firefox": true,
      "huawei_android": false,
      "internet_explorer": false,
      "osx": false,
      "safari": false,
      "sms": false,
      "web": false,
      "whats_app": false,
      "windows": false
    }
  }
}
 
{
  "request": {
    "auth": "Z2PLR....IRwTqHwCr",
    "application": "87E33-XXXXX",
    "device_type": 12,
    "firefox_fcm_service_account": {
      "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
      "auth_uri": "https://accounts.google.com/o/oauth2/auth",
      "client_email": "****@foobar.iam.gserviceaccount.com",
      "client_id": "115........6584854983",
      "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/****@foobar.iam.gserviceaccount.com",
      "private_key": "-----BEGIN PRIVATE KEY-----\n****uH/OU/fILL****fMJZ+i6****um8as.....\n-----END PRIVATE KEY-----\n",
      "private_key_id": "e3........8e66d9",
      "project_id": "app-firefox",
      "token_uri": "https://oauth2.googleapis.com/token",
      "type": "service_account",
      "universe_domain": "googleapis.com"
    },
    "firefox_vapid_key": "BEr....KPqQvCbU",
    "firefox_vapid_private_key": "ee....flOqmSo"
  }
}

configureApplication للبريد الإلكتروني

Anchor link to

يقوم بتكوين منصة البريد الإلكتروني للتطبيق.

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

نص الطلب

Anchor link to
الاسمالنوعالوصف
auth*stringرمز الوصول إلى API من لوحة تحكم Pushwoosh.
application*stringرمز تطبيق Pushwoosh
device_type*integerيجب أن يكون 14 للبريد الإلكتروني.
email_from_email*stringعنوان البريد الإلكتروني للمرسل. يجب أن يكون صالحًا ومُتحققًا منه.
email_from_name*stringاسم المرسل.
email_reply*stringعنوان البريد الإلكتروني للرد عليه. يجب أن يكون صالحًا ومُتحققًا منه.
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "providers": {
      "ios": false,
      "amazon": false,
      "android": false,
      "baidu_android": false,
      "chrome": false,
      "email": true,
      "firefox": false,
      "huawei_android": false,
      "internet_explorer": false,
      "osx": false,
      "safari": false,
      "sms": false,
      "web": false,
      "whats_app": false,
      "windows": false
    }
  }
}
مثال
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H",         // مطلوب. رمز الوصول إلى API من لوحة تحكم Pushwoosh
    "application": "XXXXX-XXXXX",           // مطلوب. رمز تطبيق Pushwoosh
    "device_type": 14,                      // مطلوب. 14 للبريد الإلكتروني
    "email_from_email": "email@domain.com", // مطلوب. يجب أن يكون عنوان البريد الإلكتروني صالحًا ومُتحققًا منه
    "email_from_name": "SENDER_NAME",       // مطلوب. الاسم الذي سيتم عرضه في حقل "من" في البريد الإلكتروني
    "email_reply": "email@domain.com"       // مطلوب. يجب أن يكون عنوان البريد الإلكتروني للرد صالحًا ومُتحققًا منه
  }
}