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

Edge for Private Cloud v. 4.16.05

Apigee vous fournit un portail de services pour les 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éveloppement. Les clients Edge peuvent créer leur propre portail des développeurs, dans le cloud ou sur site. Pour en savoir plus, consultez Qu'est-ce qu'un portail des 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 possède 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 cette option sur "false" (par défaut) pour activer le bouton et sur "true" pour le désactiver.
• features.devportalUrl : définissez 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 properties de l'objet. Lorsque vous définissez des propriétés sur l'organisation, la valeur des propriétés écrase 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" qui a été initialement définie sur l'organisation.