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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

إذا كان لديك مطوّرون حاليون بحاجة إلى نقلهم إلى قسم "تحقيق الربح"، اتّبِع الخطوات التالية:

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

    ملاحظة: لإلغاء رسوم الإعداد إذا سبق أن تم تحصيلها من المطوّر، اضبط مَعلمة طلب البحث waivefees على true.

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

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

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

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

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

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

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

    		 لا ينطبق نعم
    batchSize

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

    		 1 لا
    custAttn

    قيمة السمة المخصّصة المستخدَمة مع batchSize لاحتساب استخدام المعاملات.

    يجب تحديد رقم السمة المخصّصة في الرسالة كعدد صحيح موجب أو عدد عشري (بما يصل إلى أربعة منازل عشرية). لا يُسمح بالقيم السالبة.

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

    		 لا ينطبق نعم
    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 للعملة، مثل usd للدولار الأمريكي أو chf للفرنك السويسري.

    		 لا ينطبق نعم
    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