Étape 4 : Modifiez le point de terminaison cible

Vous consultez la documentation d'Apigee X.
Consultez la documentation d'Apigee Edge.

Maintenant que vous avez testé votre nouveau proxy, vous êtes presque prêt à lui ajouter une règle. Toutefois, avant cela, modifiez le point de terminaison cible de votre proxy pour en choisir un qui puisse renvoyer des données.

Rappelez-vous qu'à l'étape Créer un proxy d'API, vous avez défini le point de terminaison cible (dans le champ API existante) sur https://mocktarget.apigee.net. Supposons que le point de terminaison n'ait renvoyé aucune donnée intéressante. Vous pouvez ensuite remplacer le point de terminaison par un élément renvoyant un fichier XML utile. Cette section explique la procédure à suivre.

Nouvel éditeur de proxys

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

Connectez-vous à l'UI Apigee.
Sélectionnez Développer > Proxys d'API.
Sélectionnez votre proxy dans la liste pour afficher l'onglet Présentation de ce proxy dans l'éditeur de proxy. Si votre proxy ne figure pas dans la liste, vérifiez que vous avez sélectionné l'organisation appropriée, comme décrit dans la section Passer d'une organisation à une autre.
Cliquez sur l'onglet Développer : Si le bouton Essayer s'affiche, cliquez dessus pour afficher la nouvelle page Développer.

À propos du bouton Essayer

Si c'est la première fois que vous utilisez la nouvelle version de l'éditeur de proxy, la bannière suivante s'affiche en haut de la vue Développer :

Cliquez sur le bouton Essayer pour afficher la nouvelle version de la vue Développer :

Remarque : Si vous avez précédemment cliqué sur le bouton Essayer, celui-ci ne s'affiche pas.

La vue Développer est présentée ci-dessous.
Dans le volet de gauche, sélectionnez Points de terminaison cibles > Par défaut :
Cliquez sur Passer à l'éditeur de texte. Le code XML du point de terminaison cible s'affiche dans l'éditeur de texte.

Le point de terminaison cible est défini par l'élément <URL> dans <HTTPTargetConnection>.
Remplacez URL par https://mocktarget.apigee.net/xml. (Ajoutez "/xml" à l'URL existante.)

La nouvelle URL renvoie un petit bloc de code XML dans le corps de la réponse.

La configuration du point de terminaison devrait maintenant ressembler aux lignes ci-dessous :
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
Pour enregistrer vos modifications dans la configuration du proxy, cliquez sur le menu à trois points à côté de Enregistrer et sélectionnez Enregistrer en tant que nouvelle révision.

Apigee enregistre vos modifications dans une nouvelle révision du proxy.
Pour déployer la nouvelle révision, cliquez sur l'onglet Présentation, puis sur Déployer.

Éditeur de proxy classique

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

Connectez-vous à l'UI Apigee.
Sélectionnez Développer > Proxys d'API.
Sélectionnez votre proxy dans la liste pour afficher ses détails. Si votre proxy ne figure pas dans la liste, vérifiez que vous avez sélectionné l'organisation appropriée, comme décrit dans la section Passer d'une organisation à une autre.
Cliquez sur l'onglet Develop (Développer) :

Vous êtes alors dirigé vers l'éditeur de proxys d'API. L'éditeur de proxys vous permet de voir la structure de votre proxy d'API et de configurer son flux. (Un flux représente le chemin d'accès par étapes emprunté par une requête de proxy d'API via la plate-forme Apigee. Les autres tutoriels couvrent le concept de flux.)

Dans le volet Navigator (Navigateur), sélectionnez Target Endpoints > default > PreFlow (Points de terminaison cibles > Par défaut > PreFlow) :

Apigee affiche les paramètres du point de terminaison dans le volet Code :

<TargetEndpoint name="default">
  <Description/>
  <FaultRules/>
  <PreFlow name="PreFlow">
    <Request/>
    <Response/>
  </PreFlow>
  <PostFlow name="PostFlow">
    <Request/>
    <Response/>
  </PostFlow>
  <Flows/>
  <HTTPTargetConnection>
    <Properties/>
    <URL>https://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

Le point de terminaison cible est défini par l'élément <HTTPTargetConnection>.

Remplacez l'URL par "https://mocktarget.apigee.net/xml". (Ajoutez "/xml" à l'URL existante.)

La nouvelle URL renvoie un petit bloc de code XML dans le corps de la réponse.

La configuration du point de terminaison devrait maintenant ressembler aux lignes ci-dessous :
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
Pour enregistrer vos modifications dans la configuration du proxy, cliquez sur le bouton Enregistrer.

Apigee enregistre vos modifications dans une nouvelle révision du proxy.
Pour déployer la nouvelle révision, sélectionnez Deploy to: test (Déployer vers : test), puis cliquez sur Deploy 2 (Déployer 2).
Dans la boîte de dialogue de confirmation, cliquez sur Deploy (Déployer).
Si une erreur se produit, Apigee enregistre vos modifications, mais ne déploie pas le proxy. En cas d'erreur :
1. Corrigez la configuration du proxy. Apigee peut fournir des conseils de syntaxe dans une fenêtre pop-up.
2. Déployez manuellement vos modifications dans l'environnement test en cliquant sur Deployment > test (Déploiement > test) si Apigee ne les déploie pas automatiquement.
Vous pouvez vérifier si votre révision de proxy a bien été déployée en affichant l'état de la révision de déploiement à côté de la liste déroulante Deploy (Déployer). Exemple :

Tester le proxy

Vous pouvez tester vos modifications en envoyant une requête à votre proxy, comme vous l'avez fait dans la section Appeler votre proxy d'API. Exemple :

curl -v https://YOUR_ENV_GROUP_HOSTNAME/myproxy

où YOUR ENV_GROUP_HOSTNAME est le nom d'hôte du groupe d'environnements. Consultez la page Rechercher le nom d'hôte du groupe d'environnements.

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.

Étape suivante

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