نقل بيانات مطوّري البرامج إلى ميزة تحقيق الربح

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

إذا كان لديك مطوّرو برامج حاليون بحاجة إلى تفعيل ميزة "تحقيق الربح":

  1. إنشاء منتجات واجهة برمجة التطبيقات وحزم واجهة برمجة التطبيقات وخطط الأسعار للمطوّرين إذا لم تكن موجودة بالفعل. لمزيد من المعلومات، يُرجى الاطّلاع على:
  2. انشر خطط الأسعار، كما هو موضّح في خطط أسعار النشر.
  3. إضافة المطوِّرين الجُدد إلى مؤسستك، على النحو الموضّح في تسجيل مطوّري التطبيقات.
  4. إضافة رصيد دفع مسبق لكل مطوّر، كما هو موضّح في مقالة إدارة حساب الدفع المسبق والتوازن.
  5. اقبل خطة الأسعار كما هو موضّح في مقالة سعر الشراء للخطط باستخدام واجهة برمجة التطبيقات.

    ملاحظة: للتنازل عن رسوم الإعداد، إذا سبق أن تم تحصيل رسوم المطوِّر، يُرجى ضبط معلَمة طلب البحث waivefees إلى true

  6. إذا كان المطوّر الذي تنقل بياناته لديه معاملات حالية، يمكنك نقل استخدام المعاملة يدويًا باستخدام المرجع التالي:
    /organizations/{org_name}/transactions، حيث {org_name} هو اسم المؤسسة.

    ملاحظة: إذا لم يكن لدى المطوِّر معاملات حالية، يمكنك تخطّي هذه الخطوة .

    يُدرج مورد transactions معاملة واحدة تعكس استخدام المعاملات الحالية وتعديل جميع العدّادات الداخلية لتظهر هذه القيمة الجديدة

    على سبيل المثال، إذا أرسل المطوّر 1000 طلب بيانات إلى واجهة برمجة التطبيقات قبل عملية النقل، إلى لتسجيل النشاط الحالي، يمكنك تعيين استخدام المعاملة على 1000 من خلال طلب مورد "transactions" وضبط السمة "batchSize" على 1,000 بوصة نص الطلب.

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

    الموقع الوصف تلقائي مطلوب؟
    application

    رقم تعريف تطبيق المطوِّر

    		 لا ينطبق نعم
    batchSize

    عدد المعاملات التي تريد نقلها

    		 1 لا
    custAttn

    قيمة السمة المخصّصة المستخدمة مع التحقّق من حجم الدفعات لاحتساب استخدام المعاملات.

    يجب تحديد رقم السمة المخصّصة في الرسالة كعدد صحيح موجب. أو القيمة العشرية (حتى أربعة مواضع عشرية). القيم السلبية غير مسموح بها.

    يجب تحديد السمة المخصّصة في:

    		 لا ينطبق نعم
    product

    معرّف منتج واجهة برمجة التطبيقات.

    		 لا ينطبق نعم
    type

    ويجب ضبطه على CHARGE (وهو الإعداد التلقائي).

    		 CHARGE لا

    لتخطي خطوات التحقق وفرض عدد المعاملات، قم بتعيين معلَمة طلب البحث force إلى true (على سبيل المثال، ?force=true). بشكلٍ تلقائي، يتم تنفيذ ?force=false وخطوات التحقق وتنفيذه. على سبيل المثال، إذا لم يكن لدى المطوّر الذي يعمل بنظام الدفع المسبق أي رصيد أو نشاط في الحساب معلّق، في حال ?force=false سيتعذّر تنفيذ الطلب أثناء عملية التحقّق.

    على سبيل المثال، يضبط الطلب التالي عدد المعاملات على 50 للمعاملات المحددة التطبيق ومنتج واجهة برمجة التطبيقات:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize":50
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password

    يضبط الطلب التالي استخدام المعاملة على 12.5 للتطبيق المحدد منتج واجهة برمجة التطبيقات. في الطلب، تم ضبط batchSize على 125 والقيمة. تم ضبط السمة المخصّصة الأولى المحدّدة لمنتج واجهة برمجة التطبيقات على 0.1. فعندما ضرب 125 × 0.1 12.5.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize": 125,
   "custAtt1" : 0.1
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password
  7. إذا لم يتم تحصيل رسوم الإعداد اللازمة أو الرسوم المتكرّرة من أحد المطوّرين، يمكنك إجراء ذلك يدويًا يمكنك تحصيل رسوم متكررة أو عملية إعداد لخطة أسعار باستخدام المرجع التالي:
    /organizations/{org_name}/transactions، حيث {org_name} هو اسم المؤسسة.

    ملاحظة: إذا سبق أن تم تحصيل رسوم الإعداد أو الرسوم المتكررة من المطوّر، يمكنك تخطي هذه الخطوة. لن يؤثر طلب المرجع transactions في عملية الإعداد أو الرسوم المتكررة المحددة في خطة الأسعار.

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

    الموقع الوصف تلقائي مطلوب؟
    currency

    العملة المُستخدَمة في خطة الأسعار حدِّد رمز ISO 4217 للعملة، مثل الدولار الأمريكي أو الفرنك السويسري للفرنك السويسري.

    		 لا ينطبق نعم
    developer

    رقم تعريف المطوّر

    		 لا ينطبق نعم
    rate

    رسوم الإعداد أو الرسوم المتكررة لتحصيلها

    		 لا ينطبق نعم
    ratePlan

    رقم تعريف خطة الأسعار.

    		 لا ينطبق نعم
    type

    اضبط النوع على SETUPFEES أو RECURRINGFEES.

    		 CHARGE نعم

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

    على سبيل المثال، يفرض الطلب التالي رسم إعداد بقيمة 10 دولارات أمريكية (أو ما يعادلها بالعملة المحلية) من اشتراك المطوّر في خطة الأسعار:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev1@myorg.com"
   },
   "currency":{
     "id":"usd"
   },
   "ratePlan":{
     "id":"mypackage_rateplan1"
   },   
   "rate":10,
   "type":"SETUPFEES"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password