הגדרת כתובת ה-URL של פורטל השירותים למפתחים

Edge for Private Cloud גרסה 4.16.09

Apigee מספקת לך פורטל שירותים למפתחים שאפשר להשתמש בו כדי לבנות ולהשיק אתר מותאם אישית משלך, כדי לספק את כל השירותים האלה לקהילת הפיתוח. לקוחות 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"
}

רושמים מאפיינים קיימים באזור מאפיינים של האובייקט. כשמגדירים מאפיינים לארגון, הערך במאפיינים מחליף את כל המאפיינים הקיימים. לכן, אם רוצים להגדיר את 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 שהוגדר במקור בארגון.