Ustawianie adresu URL portalu

Apigee udostępnia portal usług dla deweloperów Apigee (lub po prostu portal), za pomocą którego możesz utworzyć i uruchomić własną, dostosowaną witrynę, aby udostępniać wszystkie te usługi społeczności deweloperów. Klienci Edge mogą utworzyć własny portal dla programistów w chmurze lub lokalnie. Więcej informacji znajdziesz w artykule Co to jest portal dla programistów?.

W interfejsie Edge na stronie Opublikuj > Deweloperzy wyświetla się przycisk DevPortal, który po kliknięciu otwiera portal powiązany z organizacją. Domyślnie ten przycisk otwiera ten adres URL:

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

orgname to nazwa organizacji.

Możesz ustawić inny adres URL, na przykład jeśli Twój portal ma rekord DNS, lub całkowicie wyłączyć przycisk. Aby kontrolować przycisk, użyj tych właściwości organizacji:

  • features.devportalDisabled: ustaw wartość „false” (domyślnie), aby włączyć przycisk, lub „true”, aby go wyłączyć.
  • features.devportalUrl: ustaw adres URL portalu dla programistów.

Te właściwości ustawiasz osobno dla każdej organizacji. Aby ustawić te właściwości, najpierw użyj tego wywołania interfejsu API, aby określić bieżące ustawienia właściwości w organizacji:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

To wywołanie zwraca obiekt opisujący organizację w formie:

{
  "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"
}

Zwróć uwagę na wszystkie istniejące właściwości w obszarze properties obiektu. Gdy ustawisz właściwości w organizacji, wartość we właściwościach zastąpi wszystkie bieżące właściwości. Dlatego jeśli chcesz ustawić features.devportalDisabled lub features.devportalUrl w organizacji, pamiętaj, aby podczas ustawiania skopiować wszystkie istniejące właściwości.

Aby ustawić właściwości organizacji, użyj tego wywołania 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"
        }
      ]
    }
  }'

W wywołaniu PUT musisz podać tylko displayName, name i properties. Zwróć uwagę, że to wywołanie zawiera właściwość „foo”, która została pierwotnie ustawiona w organizacji.