Étape 3 : Appeler un proxy d'API

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

Consultez la documentation d'Apigee Edge.

Maintenant que vous avez créé un proxy, vous êtes prêt à le tester en appelant le proxy. Si une entrée de système de noms de domaine (DNS) a été configurée pour le nom d'hôte du groupe d'environnements de votre organisation, vous pouvez appeler le proxy comme suit :

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

où YOUR_ENV_GROUP_HOSTNAME est le nom d'hôte d'un groupe d'environnements contenant l'environnement dans lequel votre proxy est déployé. Consultez la page Rechercher le nom d'hôte du groupe d'environnements.

Un appel réussi au proxy renvoie le résultat suivant :

Hello, Guest!

Si le nom d'hôte du groupe d'environnements a été configuré lors du provisionnement à l'aide d'un service générique, tel que nip.io, vous pouvez appeler le proxy sans avoir à configurer d'entrée DNS. Exemple :

curl https://IP_ADDRESS.nip.io/myproxy

Dans ce cas, le nom d'hôte du groupe d'environnements est IP_ADDRESS.nip.io, où IP_ADDRESS est l'adresse IP de l'hôte.

Si une erreur s'affiche, vérifiez les points suivants :

• Si vous rencontrez une erreur de délai avant expiration (inhabituel), essayez d'annuler le déploiement et de redéployer le nouveau proxy d'API.
• Si l'hôte ne peut pas être résolu, par exemple si vous recevez une erreur 404, vérifiez que vous utilisez le nom d'hôte et le nom de proxy corrects. Vous trouverez le nom d'hôte dans l'UI Apigee. Accédez à Administrateur > Environments > Groupes pour afficher le nom d'hôte ou les noms d'hôte.
• Si vous rencontrez une erreur TLS/SSL, telle qu'une erreur de handshake SSL, contactez votre fournisseur DNS pour vous assurer que l'enregistrement DNS A du nom d'hôte est correctement configuré. Assurez-vous que l'enregistrement possède l'adresse IP de l'équilibreur de charge qui a été créé lors du provisionnement d'Apigee. Si vous ne savez pas quelle adresse IP vous devez utiliser, consultez la section Déterminer si l'équilibreur de charge cloud est configuré pour un nom d'hôte.
• Si vous rencontrez une erreur de certificat TLS/SSL, il est possible que le certificat SSL associé à l'équilibreur de charge ne dispose pas du nom d'hôte approprié et qu'il soit donc refusé. Le certificat a été créé lors du processus de provisionnement. La procédure de dépannage de la section Déterminer si l'équilibreur de charge cloud est configuré pour un nom d'hôte vous montre comment localiser et inspecter le certificat.
• Si vous ne parvenez pas à résoudre le problème, contactez la personne qui a provisionné Apigee pour obtenir de l'aide.

Trouver le nom d'hôte du groupe d'environnements

Si vous ne connaissez pas le nom d'hôte du groupe d'environnements, vous pouvez le trouver comme suit :

1. Dans l'interface utilisateur Apigee, sélectionnez Administrateur > Environnements > Groupes.

2. Recherchez une ligne affichant l'environnement dans lequel votre proxy est déployé. Par exemple, si l'environnement est test-1, la ligne peut apparaître comme suit :

   

   Le nom d'hôte du groupe d'environnements pour cet environnement est api-test.exco.com.

Dans ce cas, la commande curl permettant d'appeler le proxy est la suivante :

curl https://api-test.exco.com/myproxy

À l'étape suivante, vous allez modifier le point de terminaison cible pour renvoyer les données XML du service cible.