הגדרת כתובת ה-URL של הפורטל

Apigee מספק לך את הפורטל של Apigee Developer Services (או פשוט, הפורטל), שבו אפשר להשתמש כדי לבנות ולהשיק אתר מותאם אישית משלך שיספק את כל השירותים האלה לקהילת הפיתוח. לקוחות Edge יכולים ליצור פורטל מפתחים משלהם, בענן או בארגון. למידע נוסף, ראו מהו פורטל למפתחים?.

בממשק המשתמש של Edge מוצג הלחצן DevPortal בדף פרסום > מפתחים. לחיצה על הלחצן הזה פותחת את הפורטל המשויך לארגון. כברירת מחדל, הלחצן פותח את כתובת ה-URL הבאה:

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

כאשר orgname הוא שם הארגון.

אפשר להגדיר את כתובת ה-URL הזו לכתובת URL אחרת. לדוגמה, אם יש בפורטל שלך רשומת DNS, או להשבית את הלחצן לגמרי. כדי לשלוט בלחצן צריך להשתמש במאפיינים הבאים של הארגון:

  • features.devportalDisabled: מגדירים את הערך כ-false (ברירת מחדל) כדי להפעיל את הלחצן ואת הערך True כדי להשבית אותו.
  • features.devportalUrl: מוגדר לכתובת ה-URL של פורטל המפתחים.

את המאפיינים האלה מגדירים בנפרד לכל ארגון. כדי להגדיר את המאפיינים האלה, קודם צריך להשתמש בקריאה הבאה ל-API כדי לקבוע את הגדרות הנכס הנוכחיות בארגון:

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" שהוגדר במקור בארגון.