ضبط عنوان URL للبوابة

توفّر لك Apigee بوابة "خدمات مطوّري برامج Apigee" (أو ببساطة، البوابة) التي يمكنك استخدامها لإنشاء وإطلاق موقعك الإلكتروني المخصّص لتقديم كل هذه الخدمات إلى منتدى المطوّرين. يمكن لعملاء Edge إنشاء بوابة مخصّصة للمطوّرين، إما في السحابة الإلكترونية أو داخل المؤسسة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ما هي البوابة المخصّصة للمطوّرين؟

تعرض واجهة مستخدم Edge الزر DevPortal في صفحة نشر > المطوّرون، والذي يؤدي النقر عليه إلى فتح البوابة المرتبطة بمؤسسة. يفتح هذا الزر تلقائيًا عنوان URL التالي:

http://live-orgname.devportal.apigee.com

حيث orgname هو اسم المؤسسة.

يمكنك ضبط عنوان URL هذا على عنوان URL مختلف، على سبيل المثال إذا كانت بوابتك تحتوي على سجلّ نظام أسماء النطاقات، أو يمكنك إيقاف الزر تمامًا. استخدِم السمات التالية للمؤسسة للتحكّم في الزر:

  • ‫features.devportalDisabled: اضبط القيمة على false (تلقائيًا) لتفعيل الزر، وعلى true لإيقافه.
  • ‫features.devportalUrl: يتم ضبطه على عنوان URL للبوابة المخصّصة للمطوّرين.

يمكنك ضبط هذه السمات بشكل منفصل لكل مؤسسة. لضبط هذه السمات، عليك أولاً استخدام طلب البيانات التالي من واجهة برمجة التطبيقات لتحديد إعدادات السمات الحالية في المؤسسة:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

يعرض هذا الطلب عنصرًا يصف المؤسسة بالشكل التالي:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "organme",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

دوِّن أي سمات حالية في منطقة properties للعنصر. عند ضبط السمات في المؤسسة، تحلّ القيمة في السمات محلّ أي سمات حالية. لذلك، إذا أردت ضبط السمة features.devportalDisabled أو features.devportalUrl في المؤسسة، تأكَّد من نسخ أي سمات حالية عند ضبطها.

استخدِم طلب PUT التالي لضبط السمات في المؤسسة:

curl -H "Content-Type:application/json" -u adminEmail:pword -X PUT \
  http://ms_IP:8080/v1/organizations/orgname \
  -d '{
    "displayName" : "orgname",
    "name" : "orgname",
    "properties" : {
      "property" : [
        {
          "name" : "foo",
          "value" : "bar"
        },
        {
          "name": "features.devportalUrl",
          "value": "http://dev-orgname.devportal.apigee.com/"
        },
        {
          "name": "features.devportalDisabled",
          "value": "false"
        }
      ]
    }
  }'

في طلب PUT، عليك فقط تحديد displayName وname وproperties. يُرجى العِلم أنّ هذا الطلب يتضمّن السمة "foo" التي تم ضبطها في الأصل على المؤسسة.