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

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

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

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

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

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

• features.devportalDisabled: מוגדר כ-False (ברירת מחדל) כדי להפעיל את הלחצן ו כדי להשבית אותה.
• 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" שהוגדר במקור בארגון.