إدارة العملات المعتمدة

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

مقدمة

كجزء من عملية الإعداد الأولية لتحقيق الربح، قرّر فريق إعداد Apigee Edge تحدّد هذه السياسة العملات والعملة التلقائية التي تعتمدها مؤسستك.

يمكنك عرض العملات التي تتيحها مؤسستك أو إضافة العملات المتاحة. حذف العملات المتاحة (إذا لم يستخدم المطوِّر أو خطة أسعار العملات)

إدارة العملات المتاحة باستخدام واجهة المستخدم

يمكنك إدارة العملات المعتمَدة وضبط العملة التلقائية في سمتَي "الضريبة" و"العملة" في صفحة "ملف تعريف المؤسسة". راجع الإدارة ملف المؤسسة باستخدام واجهة المستخدم للاطّلاع على التفاصيل.

إدارة العملات المتاحة باستخدام واجهة برمجة التطبيقات

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

عرض العملات المتاحة باستخدام واجهة برمجة التطبيقات

عرض عملة فردية معتمَدة في مؤسستك أو جميع العملات التي تدعمها مؤسستك

لعرض عملة فردية تدعمها مؤسستك، يمكنك إصدار طلب GET إلى /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId}، حيث {supportedCurrency_id} هو تحديد العملة المسموح بها تمت المشاهدة. على سبيل المثال:

curl -X GET -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password

لعرض جميع العملات التي تتيحها مؤسستك، يمكنك إصدار طلب GET إلى /mint/organizations/{org_name}/supported-currencies على سبيل المثال:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -H "Accept: application/json"  \
-u email:password

يقدم ما يلي مثالاً على الرد:

{
"supportedCurrency" : [ {
    "description" : "US Dollar",
    "displayName" : "US Dollar",
    "id" : "usd",
    "name" : "USD",
    "organization" : {
      ...
    "status" : "ACTIVE",
    "virtualCurrency" : false
  }, {
    "creditLimit" : 5000.0000,
    "description" : "Euro",
    "displayName" : "Euro",
    "id" : "eur",
    "name" : "EUR",
    "organization" : {
      ...
    },
    "status" : "INACTIVE",
    "virtualCurrency" : false  
  } ],
  "totalRecords" : 2
}

ضبط العملة التلقائية باستخدام واجهة برمجة التطبيقات

يمكنك ضبط العملة التلقائية للمؤسسة من خلال ضبط قيمة currency على عملة ISO 4217 متوافقة. عند تعديل الملف الشخصي للمؤسسة، كما هو موضح في إدارة المؤسسة باستخدام واجهة برمجة التطبيقات.

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

يمكنك تعديل عملة معتمدة من خلال إصدار طلب PUT إلى /mint/organizations/{org_name}/{supportedCurrencyId}، حيث {supportedCurrency_id} هو تحديد العملة المسموح بها تحديث. يلزمك تحديد الخصائص المعدَّلة في نص الطلب بالإضافة إلى معرّف العملة المتوافق. على سبيل المثال، في ما يلي طلب بيانات من واجهة برمجة التطبيقات تعمل على تعديل الوصف والاسم المعروض لعملة معتمدة (تكون الخصائص التي تم تحديثها كما هو موضح في المثال):

curl -H "Content-Type: application/json" -X PUT -d \
  '{
     "description": "United States Dollar",
     "displayName": "United States Dollar",
     "id": "usd",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status" : "ACTIVE",
     "virtualCurrency": "false"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organization/{org_name}/supported-currencies/usd" -d \
  -u email:password

حذف عملة متوافقة باستخدام واجهة برمجة التطبيقات

يمكنك حذف عملة معتمدة من خلال إصدار طلب DELETE إلى /mint/organizations/{org_name}/supported-currencies/{currency_id}، حيث {currency_id} هو تحديد العملة المسموح بها المراد حذفها. بالنسبة مثال:

curl -X DELETE -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
  -u email:password

خصائص ضبط العملة لواجهة برمجة التطبيقات

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