Transmettre un proxy à un service SOAP

Dans ce tutoriel, vous apprendrez à placer un proxy d'API Edge devant un serveur Web Google Cloud.

Ce tutoriel explique comment générer une nouvelle API RESTful devant vos requêtes Google Cloud. Bien que cela ne soit pas décrit en détail ici, vous pouvez également générer un proxy pass-through qui accepte une charge utile SOAP et la transmet au service de backend.

Prérequis

• Un compte Apigee Edge. Si vous n'en avez pas encore, vous pouvez vous inscrire à l'aide des instructions de la section Créer un compte Apigee Edge.

Créer le proxy

Ici, vous demanderez à Edge de générer le proxy qui se trouvera devant un service SAP. Il existe deux types de proxys d'API SOAP:

• REST-SOAP-REST génère une nouvelle API RESTful avec une traduction vers le protocole SOAP. Les clients l'appellent comme ils le feraient pour d'autres services RESTful, en transmettant la requête nécessaires au service de backend. Edge le traduit en charge utile SOAP attendu par le service.
• Le type de proxy pass-through Proxy permet aux clients de transmettre simplement une charge utile SOAP. Cela permet de faire en sorte que les appels au service SOAP bénéficient des fonctionnalités de gestion Edge.

Tester le proxy

Pour tester le proxy que vous avez créé, ouvrez une invite de commande et utilisez cURL. Saisissez la commande ci-dessous, où:

• ORG est le nom de l'organisation Edge dans laquelle vous avez créé le proxy.
• ENV est l'environnement dans lequel le proxy est déployé.
• DOMAIN correspond à l'instance Edge que vous utilisez.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Par exemple, si votre organisation est docfood, l'environnement est test et que vous utilisez le cloud d'entreprise Edge, vous devez exécuter une commande telle que ceci:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Si vous avez saisi GOOG pour le paramètre de requête StockSymbol, vous devriez obtenir le résultat suivant : le cours actuel des actions de classe C d'Alphabet Inc. Exemple :

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

Obtenir l'OpenAPI généré automatiquement Spécification

Lorsque vous utilisez le proxy d'un service SOAP en utilisant « REST à SAP vers REST », Edge génère automatiquement une spécification OpenAPI. Vous pouvez utiliser Spécification OpenAPI afin de générer la documentation de l'API pour l'API.

Pour obtenir la spécification OpenAPI, il vous suffit d'accéder à cette URL:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

Bonus: comment déterminez-vous quels paramètres de ressource, de verbe et de requête utiliser ?

Dans l'appel d'API de test, vous avez utilisé une ressource et des paramètres de requête spécifiques dans votre appel cURL. au service SOAP de backend. Mais comment pouvez-vous le savoir par vous-même ?

Ressource et verbe

Dans l'assistant du proxy d'API, lors de la création du proxy, vous avez vu comment les opérations SOAP correspondrait aux verbes et ressources de l'API. Mais si vous ne les avez pas écrites, voici comment vous savoir après la création du proxy.

Dans l'onglet Develop (Développer) du proxy d'API, le volet de navigation de gauche contient une de flux sous les points de terminaison du proxy. Cliquez sur le flux qui vous intéresse. Par exemple : le flux GetQuote est un bon candidat. Affichez ensuite le fichier XML dans le volet Code, qui indique le chemin d'accès à la ressource et le verbe pour le flux dans la condition <Condition> : /quote et GET.

Paramètres de requête

Après avoir sélectionné le flux GetQuote, cliquez sur la première règle dans l'interface graphique flux d'affichage. Il doit s'agir d'une règle Extract Variables qui capture les paramètres de requête qui sont devant être transmis: StockSymbol et LicenseKey. (Si vous étudiez rechercher le service SOAP, il vous indique ce qu'il faut transmettre pour la clé de licence.)

Les paramètres de requête capturés sont enregistrés en tant que variables et utilisés par la règle suivante pour de créer le message SOAP.