Définir l'URL du portail des services pour les développeurs

Edge pour Private Cloud v. 4.16.09

Apigee vous fournit un portail de services dédiés aux développeurs 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, que ce soit dans le cloud ou sur site. Pour en savoir plus, consultez la section "Qu'est-ce qu'un portail pour les développeurs ?".

L'interface utilisateur d'Edge affiche le bouton DevPortal sur la page Publier > Développeurs. Lorsque vous cliquez dessus, le portail associé à une organisation s'ouvre. 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éfinir sur "false" (par défaut) pour activer le bouton et sur "true" pour le désactiver.
• features.devportalUrl: doit être défini sur l'URL du portail des développeurs.

Vous définissez ces propriétés séparément pour chaque organisation. Pour définir ces propriétés, vous devez d'abord utiliser l'appel d'API suivant pour déterminer les paramètres de propriété actuels de 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 au format suivant:

{
  "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 les propriétés existantes dans la zone propriétés de l'objet. Lorsque vous définissez des propriétés sur l'organisation, la valeur des propriétés écrase 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 au moment de les définir.

Utilisez l'appel PUT suivant pour définir des propriétés sur 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, vous devez uniquement spécifier displayName, name et properties. Notez que cet appel inclut la propriété "foo" qui était initialement définie sur l'organisation.