Modèles de livre de recettes proxy d'API

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X.
info

Cette section présente certains des modèles de développement de proxys d'API illustrés dans les exemples de recettes Apigee Edge. À mesure que nous ajouterons d'autres exemples de livres de recettes, nous prévoyons d'ajouter d'autres modèles à ce sujet.

Modèle de client HTTP JavaScript

Le modèle de client HTTP JavaScript est l'un des nombreux modèles que vous pouvez utiliser pour créer des mashups côté serveur avec Apigee Edge. Le modèle d'objet JavaScript d'Apigee vous permet de connecter du code JavaScript directement à un flux de proxy d'API. L'objet httpClient du modèle d'objet vous permet d'effectuer des appels aux services backend et de récupérer des résultats à l'aide de JavaScript.

Modèle de composition des règles

La composition de règles est un modèle de proxy d'API Apigee qui vous permet de combiner les résultats de plusieurs cibles backend dans une seule réponse à l'aide de règles. En effet, la composition de règles vous permet de créer des mashups à l'aide de règles.

La règle ServiceCallout est au cœur du modèle de composition des règles. La règle ServiceCallout agit en tant que client HTTP pour l'API ou le service de backend. Toutefois, pour être complètement fonctionnel, un ServiceCallout s'appuie sur d'autres règles pour permettre une interaction significative avec une API ou un service distant. D'autres règles sont utilisées pour générer le message de requête envoyé par ServiceCallout et pour analyser le contenu du message de réponse de l'API ou du service distant.

L'exemple de livre de recettes sur la composition de règles utilise trois règles: AssignMessage, ServiceCallout et ExtractVariables. Ces règles encapsulent le ou les messages de requête que vous souhaitez envoyer au backend, le client qui achemine le message vers le backend et un analyseur de messages qui analyse la réponse de chaque API et attribue des variables aux données de réponse. Une fois tous les appels effectués, les variables collectées sont combinées et renvoyées dans un seul objet JSON.

Voici un bref récapitulatif de ces trois règles:

  • AssignMessage: crée un message de requête, renseigne les en-têtes HTTP et les paramètres de requête, définit le verbe HTTP.
  • ServiceCallout: référence un message créé par la règle AssignMessage, définit une URL cible pour l'appel externe, et définit un nom pour l'objet de réponse renvoyé par le service cible.
  • ExtractVariables: définit généralement une expression JSONPath ou XPath qui analyse le message généré par la règle ServiceCallout précédente. La règle définit ensuite des variables contenant les valeurs analysées à partir de la réponse de ServiceCallout.

Consultez la section Utiliser la composition de règle pour obtenir un exemple complet illustrant le modèle de composition de règles.