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

يتم الآن عرض مستندات 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 على 1000 في نص الطلب.

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

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

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

    		 لا ينطبق نعم
    batchSize

    عدد المعاملات التي تريد تحويلها.

    		 1 لا
    custAttn

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

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

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

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