خطط معدّل الشراء باستخدام واجهة برمجة التطبيقات

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

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

شراء خطة أسعار منشورة باستخدام واجهة برمجة التطبيقات

وبعد نشر خطة الأسعار، يمكن للمطوّر أو الشركة شراؤها (أو "قبولها") من خلال إصدار طلب POST إلى /mint/organizations/{org_name}/developers/{developer_or_company_id}/developer-rateplans, حيث يكون {org_name} هو اسم المؤسسة {developer_or_company_id} هو رقم تعريف المطوّر أو الشركة.

للتنازل عن رسوم الإعداد عند شراء خطة أسعار، عليك ضبط معلَمة طلب البحث "waivefees". إلى true. تكون هذه العلامة مفيدة عند نقل بيانات المطوّرين إلى تحقيق الربح، مثل الموضَّحة في مقالة نقل بيانات المطوّرين إلى تحقيق الربح

ويلخّص الجدول التالي خصائص الضبط التي يمكنك تحديدها في نص الطلب وقيمها الافتراضية وما إذا كانت مطلوبة أم لا.

على سبيل المثال، يشتري الطلب التالي خطة أسعار "location_&_messaging". للمطوّر المحدّد:

curl "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/developer-rateplans" \
  -X POST \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "developer":{
     "id":"5cTWgdUvdr6JW3xU"
   },
   "startDate":"2017-08-30",
   "ratePlan":{
     "id":"location_&_messaging"
   },
   "suppressWarning":false
  }'

في هذا المثال، يتم ضبط السمة suppressWarning على false. ضِمن في هذه الحالة، سيحدث خطأ في حالة حدوث تعارض. على سبيل المثال، إذا مطور محاولة شراء خطة أسعار تتداخل مع خطة أسعار مشتراة أخرى، فقد حدث خطأ. هذا النمط يمكّن تطبيقًا يوفر واجهة مستخدم لتحقيق الربح لاعتراض الخطأ عرض المنتجات المتضاربة لمطوّر البرامج لتأكيدها (حسب الاقتضاء). في حال حذف تم ضبط suppressWarning على true. تؤدي ميزة تحقيق الربح إلى إنهاء كل عمليات الشراء التي تم شراؤها. لخطط الأسعار التي يحتاجها المطوّر إلى إعداد حِزم واجهة برمجة التطبيقات التي تحتوي على المنتجات المتعارضة. ثم حزمة واجهة برمجة تطبيقات جديدة للمطور.

يشتري الطلب التالي خطة قابلة للتعديل لمعدّل الإشعارات ويحدّد الرقم المستهدف. من المعاملات إلى 4000.

curl "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/developer-rateplans" \
  -X POST \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "developer":{
     "id":"5cTWgdUvdr6JW3xU"
   },
   "ratePlan":{
     "id":"adjustable-notification-plan"
   },
   "startDate": "2017-03-24",
   "quotaTarget": 4000,
   "suppressWarning":false
  }'

في أي من الأمثلة أعلاه، في حال عرض رسالة الخطأ التالية:

Developer legal name not specified. 

بعد ذلك، عليك ضبط سمتَي تحقيق الربح MINT_DEVELOPER_ADDRESS MINT_DEVELOPER_LEGAL_NAME، ثم تكرار طلب بيانات من واجهة برمجة التطبيقات.

انتهاء صلاحية خطة أسعار اشتراها مطوِّر باستخدام واجهة برمجة التطبيقات

لإنهاء (أو إلغاء) خطة أسعار اشتراها مطوِّر، عليك تعديل خطة الأسعار التي تم شراؤها. تفاصيل خطة الأسعار وتحديد السمة endDate في نص الطلب في طلب PUT المورد /organizations/{org_name}/developers/{developer_or_company_id}/developer-rateplans/{developer_rateplan_id}.

ستصبح خطة الأسعار سارية حتى نهاية اليوم في النهاية. التاريخ المحدد. مثلاً، إذا أردت انتهاء صلاحية خطة أسعار في 1 كانون الأول (ديسمبر) 2017، عليك ضبط قيمة endDate إلى 30/11/2017 في هذه الحالة، انتهاء صلاحية خطة الأسعار في نهاية اليوم في 30 تشرين الثاني (نوفمبر) 2017 جميع الطلبات في 1 ديسمبر، سيتمّ حظر عام 2017.

يتم إرجاع "{developer_rateplan_id}" في الردّ عند الشراء. خطة الأسعار المنشورة.

على سبيل المثال:

{
  "created": "2017-03-31 18:59:54",
  "developer": {
    ...
  },
  "id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
  "quotaTarget": 3000,
  "ratePlan": {
    ...
  },
  "startDate": "2017-03-31 00:00:00",
  "updated": "2017-03-31 18:59:54",
  "waiveTerminationCharge": false
}

بدلاً من ذلك، يمكنك الحصول على {developer-rateplan-id} خطة السعر الخاصة بالمطوّرين من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /organizations/{org_name}/developers/{developer_id}/developer-accepted-rateplans، حيث يشير {developer_id} إلى عنوان البريد الإلكتروني للمطوّر. لمزيد من المعلومات، المعلومات، راجع عرض جميع خطط الأسعار التي اشتراها أحد المطوّرين

يقوم الطلب التالي بتحديث تاريخ الانتهاء إلى 1 كانون الأول (ديسمبر) 2017. أي أن خطة الأسعار وستنتهي صلاحيته في نهاية اليوم يوم 30 تشرين الثاني (نوفمبر) 2017 جميع الطلبات في 1 ديسمبر 2017 محظور.

curl "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans/b1c600b8-f871-496d-8173-12b9950d6ab1"
  -X PUT \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "id" : "b1c600b8-f871-496d-8173-12b9950d6ab1",
   "developer":{
     "id":"dev@mycompany.com"
   },
   "ratePlan":{
     "id":"p1_adjustable-notification-plan"
   },
   "startDate": "2017-04-15 00:00:00",
   "endDate": "2017-11-30",
   "quotaTarget": 3000,
   "suppressWarning":false
  }'