تنظیم نشانی وب درگاه

‫Apigee دراختیارتان درگاه «خدمات توسعه‌دهنده Apigee» (یا به‌طور ساده، درگاه) قرار می‌دهد که می‌توانید از آن برای ساختن و راه‌اندازی وب‌سایت سفارشی خودتان استفاده کنید تا همه این خدمات را به انجمن توسعه‌دهندگان خود ارائه دهید. مشتریان Edge می‌توانند در فضای ابری یا در محل، درگاه توسعه‌دهنده خودشان را ایجاد کنند. برای کسب اطلاعات بیشتر، درگاه توسعه‌دهندگان چیست؟ را ببینید.

«میانای کاربری Edge» دکمه DevPortal را در صفحه انتشار > توسعه‌دهندگان نمایش می‌دهد که با کلیک کردن روی آن، درگاه مرتبط با سازمان باز می‌شود. به‌طور پیش‌فرض، آن دکمه نشانی وب زیر را باز می‌کند:

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

که در آن orgname نام سازمان است.

می‌توانید این نشانی وب را روی نشانی وب دیگری تنظیم کنید، برای مثال اگر درگاهتان سابقه ساناد دارد، یا دکمه را به‌طور کامل غیرفعال کنید. از دارایی‌های زیر سازمان برای کنترل دکمه استفاده کنید:

• features.devportalDisabled: برای فعال کردن دکمه، روی نادرست (پیش‌فرض) تنظیم کنید و برای غیرفعال کردن آن، روی درست تنظیم کنید.
• ‫features.devportalUrl: روی نشانی وب درگاه توسعه‌دهنده تنظیم شود.

این دارایی‌ها را به‌صورت جداگانه برای هر سازمان تنظیم می‌کنید. برای تنظیم این دارایی‌ها، ابتدا از فراخوانی 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» است که دراصل روی سازمان تنظیم شده بود.