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

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

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

  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