Étape 4 : Modifiez le point de terminaison cible

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Un proxy d'API Apigee comporte deux points de terminaison : un point de terminaison de proxy et un point de terminaison cible. Le point de terminaison du proxy est l'interface client. Il reçoit les requêtes des clients et leur renvoie des réponses. Le point de terminaison cible est l'interface du producteur d'API. Il communique d'Apigee à un producteur d'API, tel qu'un service ou une API de backend. Pour en savoir plus sur les points de terminaison, consultez Qu'est-ce qu'un proxy d'API ?

Au cours de cette étape, vous allez remplacer le point de terminaison cible du proxy d'API par https://mocktarget.apigee.net/xml, une ressource qui renvoie des données XML de test. Après avoir effectué la modification, vous redéployez et testez le proxy d'API révisé.

  1. Dans la console Google Cloud , accédez à la page Apigee > Développement de proxys > Proxys d'API.

    Accéder aux proxys d'API

  2. Assurez-vous que le projet Google Cloud dans lequel vous avez créé le proxy d'API est sélectionné dans le menu déroulant en haut de la page.
  3. Dans le tableau des proxys, sélectionnez le proxy myproxy que vous avez créé à l'étape 1 : Créer un proxy d'API.
  4. Cliquez sur l'onglet Develop (Développer).

Explorer la vue "Développer"

Dans le volet de gauche de la vue Develop (Développer), vous pouvez :

  • Rechercher du texte dans le proxy avec le champ Search proxy (Rechercher un proxy).
  • Ajouter de nouvelles règles.
  • Ajouter des points de terminaison de proxy et de cibles.
  • Ajouter d'autres ressources.

Si vous ne souhaitez pas afficher le volet de gauche, vous pouvez le réduire en cliquant sur le bouton de fermeture Bouton de fermeture du volet de recherche.

Le volet de droite de la vue Develop (Développer) affiche les éditeurs visuels et textuels du proxy :

  • L'éditeur visuel fournit une vue graphique du flux de requêtes et de réponses.
  • L'éditeur de texte vous permet de modifier le fichier XML pour le proxy ou la cible.

Éditeurs visuels et de texte avec des séparateurs sélectionnables.

Remarques :

  • Vous pouvez cliquer sur le séparateur et le faire glisser entre les deux éditeurs pour développer la zone d'affichage de l'un ou l'autre des deux éditeurs.
  • Vous pouvez développer la zone d'affichage de l'éditeur visuel en cliquant sur le bouton d'activation situé à droite de l'éditeur de texte, ce qui a pour effet de fermer le volet de l'éditeur de texte. Cliquez à nouveau sur le bouton d'activation pour rouvrir le volet de l'éditeur de texte.

Modifier le point de terminaison cible

Pour modifier le point de terminaison cible du proxy, procédez comme suit :

  1. Dans le volet Révision du proxy, sélectionnez Points de terminaison cibles > Par défaut.

    Points de terminaison cibles sélectionnés dans l'explorateur de proxy.

    Un diagramme du point de terminaison cible s'affiche dans l'éditeur visuel :

    Points de terminaison cibles sélectionnés dans l'explorateur de proxy.

    Sous l'éditeur visuel, le code XML du point de terminaison cible s'affiche dans l'éditeur de texte :

    Fichier XML du point de terminaison cible affiché dans l'éditeur de texte.

  2. Dans l'éditeur de texte, remplacez <URL> par https://mocktarget.apigee.net/xml. (Ajoutez "/xml" à l'URL existante.)

    La nouvelle URL est illustrée ci-dessous :

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  3. Cliquez sur la flèche à côté de Enregistrer en haut à droite de l'éditeur de proxy, puis sélectionnez Enregistrer en tant que nouvelle révision.
  4. Pour déployer vos modifications, cliquez sur Déployer.
  5. Dans la boîte de dialogue Déployer, sélectionnez la révision et l'environnement dans lesquels effectuer le déploiement, puis cliquez sur Déployer.

Tester le proxy

Pour tester la révision du proxy d'API, appelez le proxy comme vous l'avez fait dans la section Appeler un proxy d'API.

Cette fois, le point de terminaison fictif cible renvoie le code XML dans le corps de la réponse :

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

Maintenant que le proxy d'API renvoie des données XML, à l'étape suivante, vous allez ajouter une règle qui convertit XML au format JSON.

1 2 3 4 (SUIVANT) Étape 5 : Ajoutez une règle