إدارة الأحكام والشروط

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

مقدمة

عليك إضافة الأحكام والشروط إلى الملف الشخصي لمؤسستك قبل نشر خطة أسعار. أن تكون الأحكام والشروط خارج المؤسسة بك. في الملف الشخصي لمؤسستك، يمكنك تحديد موقع (عنوان URL العام) الأحكام والشروط.

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

إضافة الأحكام والشروط باستخدام واجهة المستخدم

1. ادخل إلى صفحة "الملف الشخصي للمؤسسة"، كما هو موضح في استكشاف صفحة "ملف تعريف المؤسسة".
2. انقر على تعديل.
3. في قسم "الأحكام والشروط" بصفحة "الملف الشخصي للمؤسسة"، انقر على إضافة الأحكام والشروط والشروط.

   يتم عرض مربّع حوار "الأحكام والشروط الجديدة".

4. أدخل المعلومات التالية:

   الحقل	الوصف
   تاريخ السريان	تاريخ سريان الأحكام والشروط. الإعداد الافتراضي هو الحالي التاريخ. يجب إدخال التاريخ الحالي أو في المستقبل.
   الإصدار	نسخة من الأحكام والشروط يتيح لك رقم الإصدار الاحتفاظ تتبُّع الإصدارات المختلفة من الأحكام والشروط
   عنوان URL	تمثّل هذه السمة عنوان URL الخاص بالأحكام والشروط.

5. انقر على إنشاء.

   إضافة الأحكام والشروط الجديدة إلى قسم "الأحكام والشروط" في "ملف تعريف المؤسسة" .

6. كرِّر الخطوات من 3 إلى 5 لإضافة أحكام وشروط أخرى.
7. انقر على حفظ لحفظ التغييرات في الملف الشخصي للمؤسسة.

تعديل الأحكام والشروط باستخدام واجهة المستخدم

لا يمكنك تعديل "الأحكام والشروط" مباشرةً. بدلاً من ذلك، يجب حذف الأحكام والشروط تريد تعديله ثم إضافة إدخال جديد للأحكام والشروط.

حذف الأحكام والشروط باستخدام واجهة المستخدم

1. ادخل إلى صفحة "الملف الشخصي للمؤسسة"، كما هو موضح في استكشاف صفحة "ملف تعريف المؤسسة".
2. انقر على تعديل في صفحة "الملف الشخصي للمؤسسة".
3. في قائمة "الأحكام والشروط"، ضع مؤشر الماوس فوق الأحكام والشروط التي تريد حذفها.
4. انقر على .

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

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

إضافة الأحكام والشروط باستخدام واجهة برمجة تطبيقات

أضِف الأحكام والشروط من خلال إصدار طلب POST إلى /mint/organizations/{org_name}/tncs. عند إضافة الأحكام والشروط، يمكنك تحديد ما يلي اختياريًا:

• عنوان URL
• نص مصاحب (مثل الوصف)
• تاريخ سريان الأحكام والشروط
• رقم الإصدار

يمكنك الاطّلاع على خصائص ضبط الأحكام والشروط للحصول على مزيد من المعلومات حول هذه الخيارات.

على سبيل المثال:

curl -X POST   "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "url":"www.testoperator/termsandconditions",
     "tncText":"Sample text for the T&C",
     "version":"1.1",
     "startDate":"2018-09-24"
  }' \
  -u email:password

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

{
   "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c ",
   "organization" : {     
     …
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.1"
 }

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

يمكنك الاطّلاع على الأحكام والشروط الخاصة بالمؤسسة أو جميع الأحكام والشروط الخاصة بالمؤسسة.

عرض محدّدة الأحكام والشروط من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /mint/organizations/{org_name}/tncs/{tncs_id}، حيث تشير إلى {tncs_id} هي عبارة عن تحديد الأحكام والشروط المحدّدة (يتم إرجاع المعرّف في الرد عند إنشاء البنود والشروط). على سبيل المثال:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

عرض جميع البنود والشروط للمؤسسة من خلال إصدار طلب GET إلى /mint/organizations/{org_name}/tncs على سبيل المثال:

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

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

{

"tnc" : [
  {
    "id" : "77193339-8d79-44a8-8af2-3593f16c158e",
    "organization" :
    {
      ...
    },
   "startDate" : "2018-07-01 00:00:00",
   "tncText" : "Big operator text for the T&C",
   "url" : "www.bigoperator/termsandconditions",
   "version" : "1.0"
  },
  {
    "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c3",
    "organization" : {
    ...
  },
    "startDate" : "2018-09-24 00:00:00",
    "tncText" : "Sample text for the T&C",
    "url" : "www.testoperator/termsandconditions",
    "version" : "1.1"
  }
  ]
   "totalRecords" : 2
}

قبول مستند الأحكام والشروط لمطوِّر أو شركة باستخدام واجهة برمجة التطبيقات

قبول مستند الأحكام والشروط لمطوّر برامج أو شركة محدّدين من خلال إصدار طلب POST إلى أحد واجهات برمجة التطبيقات التالية، على التوالي:

• /mint/organizations/{org_name}/developers/{dev_id}/tncs/{tncs_id}/developer-tncs
• /mint/organizations/{org_name}/companies/{company_id}/tncs/{tncs_id}/developer-tncs

حيث {dev_id} هو رقم تعريف المطوّر (عنوان البريد الإلكتروني)، و{company_id} هو رقم تعريف الشركة، و{tncs_id} هو رقم تعريف مستند الأحكام والشروط.

على سبيل المثال:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/tncs/5a291b86-42e3-4ae1-8db3-efe4b0877316/developer-tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "action":"ACCEPTED",
     "auditDate":"2018-10-01 00:00:00"
  }' \
  -u email:password

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

{
  "action": "ACCEPTED",
  "auditDate": "2018-10-01 07:24:45",
  "id": "dev2@myorg.com",
  "tnc": {
      "id": "5a291b86-42e3-4ae1-8db3-efe4b0877316",
      ...
  }
}

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

يُرجى الاطّلاع على الأحكام والشروط التي قبلها مطوِّر معيّن أو شركة معيّنة عن طريق إصدار رمز GET. إلى أحد واجهات برمجة التطبيقات التالية، على التوالي:

• /mint/organizations/{org_name}/developers/{dev_id}/developer-tncs
• /mint/organizations/{org_name}/companies/{company_id}/developer-tncs

يشير {dev_id} إلى رقم تعريف المطوّر (عنوان البريد الإلكتروني) و{company_id} هو رقم تعريف الشركة.

على سبيل المثال:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/developer-tncs" \
  -H "Accept:application/json"  \
  -u email:password

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

{
  "developerTnc": [
  {
    "action": "ACCEPTED",
    "auditDate": "2018-08-29 07:24:45",
    "id": "dev2@myorg.com",
    "tnc": {
      "id": "26abc14c-c628-4c38-8840-a343c8ee9437",
      ...
    }
  }],
  "totalRecords": 1
}

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

تعديل الأحكام والشروط من خلال إصدار طلب PUT إلى /mint/organizations/{org_named}/tncs/{tncs_id}، حيث {tncs_id} هو تحديد البنود والشروط. عند إجراء التحديث، عليك التحديد في الطلب. للإعدادات المعدَّلة وتحديد البنود والشروط. على سبيل المثال، ما يلي يطالب بتعديل رقم نسخة البنود والشروط (يتم تمييز الموقع المُعدَّل في مثال):

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/cfbb03b3-b707-495b-9b8a-ff67d71065a9" \
  -H "Content-Type: application/json" \
  -d {
    "id":"6803d70a-18cc-40c8-b250-675c5e8a75c",
    "version":"1.2"
  }' \
  -u email:password

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

{
   "id" : "cfbb03b3-b707-495b-9b8a-ff67d71065a9",
   "organization" : {
       "address" : [ {
       "address1" : "Test address",
       "city" : "Test City",
       "country" : "US",
       "id" : "test-address",
       "isPrimary" : true,
       "state" : "CA",
       "zip" : "54321"
     } ],
     …"
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.2"
 }

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

حذف الأحكام والشروط من خلال إصدار طلب حذف إلى /mint/organizations/{org_name}/tncs/{tncs_id}، حيث {tncs_id} هو تحديد البنود والشروط. على سبيل المثال:

curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

خصائص ضبط الأحكام والشروط لواجهة برمجة التطبيقات

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

الخطوات التالية

تعرَّف على كيفية إضافة العملات المتاحة إلى تلك التي تم إعدادها في البداية لمؤسستك. الإدارة المتاحة والعملات.