Ustawianie adresu URL portalu

Apigee udostępnia portal Apigee Developer Services (lub po prostu portal), z którego możesz korzystać do budowania i uruchamiania własnej dostosowanej witryny, aby udostępniać wszystkie te usługi swojej społeczności programistów. Klienci Edge mogą tworzyć własne portale dla programistów (w chmurze lub lokalnie). Więcej informacji znajdziesz w artykule Co to jest portal dla deweloperów?.

W interfejsie użytkownika Edge na stronie Opublikuj > Programiści wyświetla się przycisk DevPortal. Kliknięcie go powoduje otwarcie portalu powiązanego z organizacją. Domyślnie ten przycisk otwiera ten adres URL:

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

Gdzie orgname to nazwa organizacji.

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

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

Te właściwości ustawia się oddzielnie dla każdej organizacji. Aby skonfigurować te właściwości, najpierw musisz użyć poniższego wywołania interfejsu API w celu określenia bieżących ustawień usługi 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 formularzu:

{
  "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ępuje wszystkie obecne właściwości. Dlatego, jeśli chcesz ustawić w organizacji features.devportalDisabled lub features.devportalUrl, pamiętaj, by skopiować wszystkie istniejące usługi podczas ich konfigurowania.

Aby ustawić usługi w 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 wartości displayName, name i properties. Pamiętaj, że to wywołanie zawiera właściwość „foo”, która została pierwotnie ustawiona w organizacji.