Utilisation d’un kit SDK JavaScript généré par API Gateway pour une API REST

Pour installer, initier et appeler un kit SDK JavaScript généré par API Gateway pour une API REST

1. Extrayez le contenu du fichier .zip généré par API Gateway que vous avez précédemment téléchargé.

2. Activez le partage des ressources entre origines multiples (CORS) pour toutes les méthodes que le kit SDK généré par API Gateway appelle. Pour obtenir des instructions, consultez Partage des ressources entre origines multiples pour les API REST dans API Gateway.

3. Dans votre page web, incluez des références aux scripts suivants.

   <script type="text/javascript" src="lib/axios/dist/axios.standalone.js"></script>
   <script type="text/javascript" src="lib/CryptoJS/rollups/hmac-sha256.js"></script>
   <script type="text/javascript" src="lib/CryptoJS/rollups/sha256.js"></script>
   <script type="text/javascript" src="lib/CryptoJS/components/hmac.js"></script>
   <script type="text/javascript" src="lib/CryptoJS/components/enc-base64.js"></script>
   <script type="text/javascript" src="lib/url-template/url-template.js"></script>
   <script type="text/javascript" src="lib/apiGatewayCore/sigV4Client.js"></script>
   <script type="text/javascript" src="lib/apiGatewayCore/apiGatewayClient.js"></script>
   <script type="text/javascript" src="lib/apiGatewayCore/simpleHttpClient.js"></script>
   <script type="text/javascript" src="lib/apiGatewayCore/utils.js"></script>
   <script type="text/javascript" src="apigClient.js"></script>

4. Dans votre code, initialisez le kit SDK généré par API Gateway à l’aide d’un code similaire à ce qui suit.

   var apigClient = apigClientFactory.newClient();

   Pour initialiser le kit SDK généré par API Gateway avec des informations d’identification AWS, utilisez un code similaire à ce qui suit. Si vous utilisez des informations d’identification AWS, toutes les demandes envoyées à l’API sont signées.

   var apigClient = apigClientFactory.newClient({
     accessKey: 'ACCESS_KEY',
     secretKey: 'SECRET_KEY',
   });

   Pour utiliser une clé d’API avec le kit SDK généré par API Gateway, vous pouvez transmettre la clé d’API à l’objet Factory en tant que paramètre à l’aide d’un code similaire à ce qui suit. Si vous utilisez une clé d’API, elle est spécifiée dans l’en-tête x-api-key et toutes les demandes envoyées à l’API sont signées. Cela signifie que vous devez définir les en-têtes CORS Accept appropriés pour chaque demande.

   var apigClient = apigClientFactory.newClient({
     apiKey: 'API_KEY'
   });

5. Appelez les méthodes d’API dans API Gateway à l’aide d’un code similaire à ce qui suit. Chaque appel renvoie une promesse avec des rappels de réussite et d’échec.

   var params = {
     // This is where any modeled request parameters should be added.
     // The key is the parameter name, as it is defined in the API in API Gateway.
     param0: '',
     param1: ''
   };
   
   var body = {
     // This is where you define the body of the request,
   };
   
   var additionalParams = {
     // If there are any unmodeled query parameters or headers that must be
     //   sent with the request, add them here.
     headers: {
       param0: '',
       param1: ''
     },
     queryParams: {
       param0: '',
       param1: ''
     }
   };
   
   apigClient.methodName(params, body, additionalParams)
       .then(function(result){
         // Add success callback code here.
       }).catch( function(result){
         // Add error callback code here.
       });

   Ici, le nom methodName est construit à partir du chemin d’accès des ressources de la demande de méthode et du verbe HTTP. Pour l’API SimpleCalc, les méthodes de kit SDK pour les méthodes d’API

   1. GET /?a=...&b=...&op=...
   2. POST /
   
      { "a": ..., "b": ..., "op": ...}
   3. GET /{a}/{b}/{op}

   les méthodes de kit SDK correspondantes sont les suivantes :

   1. rootGet(params);      // where params={"a": ..., "b": ..., "op": ...} is resolved to the query parameters
   2. rootPost(null, body); // where body={"a": ..., "b": ..., "op": ...}
   3. aBOpGet(params);      // where params={"a": ..., "b": ..., "op": ...} is resolved to the path parameters