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

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

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

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

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

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