Définir l'URL du portail

Apigee met à votre disposition le portail de services pour les développeurs Apigee (ou simplement le portail) que vous pouvez utiliser pour créer et lancer votre propre site Web personnalisé afin de fournir tous ces services à votre communauté de développeurs. Les clients Edge peuvent créer leur propre portail des développeurs, dans le cloud ou sur site. Pour en savoir plus, consultez la page Qu'est-ce qu'un portail des développeurs ?.

L'interface utilisateur Edge affiche le bouton DevPortal sur la page Publish > Developers (Publier > Développeurs) qui, lorsque l'utilisateur clique dessus, ouvre le portail associé à une organisation. Par défaut, ce bouton ouvre l'URL suivante:

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

où orgname est le nom de l'organisation.

Vous pouvez définir cette URL sur une autre URL, par exemple si votre portail dispose d'un enregistrement DNS, ou désactiver complètement le bouton. Utilisez les propriétés suivantes de l'organisation pour contrôler le bouton:

• features.devportalDisabled: définissez la valeur sur "false" (par défaut) pour activer le bouton et sur "true" pour le désactiver.
• features.devportalUrl: définie sur l'URL du portail des développeurs.

Vous définissez ces propriétés séparément pour chaque entreprise. Pour définir ces propriétés, vous devez d'abord utiliser l'appel d'API suivant afin de déterminer les paramètres de propriété actuels sur l'organisation:

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

Cet appel renvoie un objet décrivant l'organisation sous la forme:

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

Notez toutes les propriétés existantes dans la zone properties de l'objet. Lorsque vous définissez des propriétés sur l'organisation, la valeur définie dans les propriétés remplace toutes les propriétés actuelles. Par conséquent, si vous souhaitez définir features.devportalDisabled ou features.devportalUrl dans l'organisation, veillez à copier toutes les propriétés existantes lorsque vous les définissez.

Utilisez l'appel PUT suivant pour définir les propriétés de l'organisation:

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"
        }
      ]
    }
  }'

Dans l'appel PUT, il vous suffit de spécifier displayName, name et properties. Notez que cet appel inclut la propriété "foo" initialement définie sur l'organisation.