

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Didacticiel sur la sélection d’une intégration HTTP
<a name="getting-started-http-integrations"></a>

 Pour créer une API avec une intégration HTTP, vous pouvez utiliser une intégration de proxy HTTP ou une intégration HTTP personnalisée.

Dans une intégration de proxy HTTP, il vous suffit de définir la méthode HTTP et l’URI du point de terminaison HTTP selon les exigences du backend. Nous vous recommandons d’utiliser l’intégration de proxy HTTP, dans la mesure du possible, pour profiter de la configuration simplifiée de l’API.

Vous pouvez utiliser l’intégration HTTP personnalisée si vous avez besoin de transformer les données de la demande du client pour le backend, ou de transformer les données de la réponse du backend pour le client. 

**Topics**
+ [Didacticiel : création d’une API REST avec une intégration de proxy HTTP](api-gateway-create-api-as-simple-proxy-for-http.md)
+ [Didacticiel : création d’une API REST avec une intégration HTTP sans proxy](api-gateway-create-api-step-by-step.md)

# Didacticiel : création d’une API REST avec une intégration de proxy HTTP
<a name="api-gateway-create-api-as-simple-proxy-for-http"></a>

L’intégration de proxy HTTP est un mécanisme simple, puissant et polyvalent pour créer une API qui permet à une application web d’accéder à plusieurs ressources ou fonctionnalités du point de terminaison HTTP intégré, comme la totalité du site web, à l’aide d’une configuration rationalisée d’une seule méthode d’API. Dans l’intégration de proxy HTTP, API Gateway transmet au backend la demande de méthode envoyée par le client. Les données de la demande transmises incluent les en-têtes de demande, les paramètres de chaîne de requête, les variables du chemin de l’URL et la charge utile. Le point de terminaison HTTP du serveur principal ou le serveur web analyse les données de la demande entrante pour déterminer la réponse qu’il renvoie. L’intégration de proxy HTTP permet l’interaction directe entre le client et le backend sans intervention d’API Gateway après la configuration de la méthode d’API, sauf pour les problèmes connus comme les caractères non pris en charge, qui sont énumérés dans les [Remarques importantes concernant Amazon API Gateway](api-gateway-known-issues.md).

Grâce à la ressource proxy globale `{proxy+}` et au verbe fourre-tout `ANY` de la méthode HTTP, vous pouvez utiliser une intégration de proxy HTTP pour créer une API d’une seule méthode d’API. La méthode expose l’ensemble des ressources et opérations HTTP accessibles publiquement d’un site web. Lorsque le serveur web principal ouvre de nouvelles ressources pour l’accès public, le client peut utiliser ces nouvelles ressources avec la même configuration d’API. Pour ce faire, le développeur du site web doit communiquer clairement au développeur du client quelles sont les nouvelles ressources et quelles opérations sont applicables pour chacune d’entre elles.



À titre de présentation rapide, le didacticiel suivant illustre l’intégration de proxy HTTP. Dans le didacticiel, nous créons une API à l'aide de la console API Gateway pour l'intégrer au PetStore site Web via une ressource proxy générique`{proxy+}`, et nous créons l'espace réservé à la méthode HTTP de`ANY`. 

**Topics**
+ [Création d’une API avec l’intégration de proxy HTTP à l’aide de la console API Gateway](#api-gateway-create-api-as-simple-proxy-for-http-build)
+ [Test d’une API avec l’intégration de proxy HTTP](#api-gateway-create-api-as-simple-proxy-for-http-test)

## Création d’une API avec l’intégration de proxy HTTP à l’aide de la console API Gateway
<a name="api-gateway-create-api-as-simple-proxy-for-http-build"></a>

 La procédure suivante explique comment créer et tester une API avec une ressource proxy pour un backend HTTP à l’aide de la console API Gateway. Le backend HTTP est le site web `PetStore` (`http://petstore-demo-endpoint.execute-api.com/petstore/pets`) provenant du [Didacticiel : création d’une API REST avec une intégration HTTP sans proxy](api-gateway-create-api-step-by-step.md), dans lequel les captures d’écran sont utilisées comme aides visuelles pour illustrer les éléments de l’interface utilisateur API Gateway. Si c’est la première fois que vous utilisez la console API Gateway pour créer une API, il se peut que vous souhaitiez suivre d’abord les instructions de cette section. 

**Pour créer une API**

1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Si vous utilisez API Gateway pour la première fois, vous voyez une page qui vous présente les fonctions du service. Sous **REST API (API REST)**, choisissez **Build (Création)**. Lorsque la fenêtre contextuelle **Create Example API (Créer API exemple)** s’affiche, cliquez sur **OK**.

   Si ce n’est pas la première fois que vous utilisez API Gateway, choisissez **Create API (Créer une API)**. Sous **REST API (API REST)**, choisissez **Build (Création)**.

1.  Sous **API name (Nom de l’API)**, saisissez **HTTPProxyAPI**.

1. (Facultatif) Sous **Description**, entrez une description.

1. Laissez **Type de point de terminaison d’API** défini sur **Régional**.

1. Pour le **type d'adresse IP**, sélectionnez **IPv4**.

1. Sélectionnez **Create API** (Créer une API).

Dans cette étape, vous créez un chemin de ressource proxy de `{proxy+}`. Il s’agit de l’espace réservé de chacun des points de terminaison du backend sous `http://petstore-demo-endpoint.execute-api.com/`. Par exemple, il peut être `petstore`, `petstore/pets` et `petstore/pets/{petId}`. API Gateway crée la méthode `ANY` lorsque vous créez la ressource `{proxy+}` et sert d’espace réservé pour chacun des verbes HTTP pris en charge au moment de l’exécution.

**Pour créer une ressource**/\$1proxy\$1\$1****

1. Choisissez votre API. 

1. Dans le volet de navigation principal, choisissez **Ressources**.

1. Choisissez **Créer une ressource**.

1. Activez **Ressource proxy**.

1. Conservez **Chemin de la ressource** sous la forme `/`.

1. Sous **Resource Name (Nom de la ressource)**, entrez **\$1proxy\$1\$1**.

1. Maintenez **CORS (Partage des ressources entre origines multiples)** désactivé.

1. Choisissez **Créer une ressource**.  
![\[Créez une ressource enfant.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/api-gateway-simple-proxy-create-proxy-resource-new-console.png)

Au cours de cette étape, vous intégrez la méthode `ANY` avec un point de terminaison HTTP de backend à l’aide d’une intégration par proxy. Dans l’intégration de proxy HTTP, API Gateway transmet au backend la requête de méthode envoyée par le client sans intervention d’API Gateway.

**Pour créer une méthode `ANY`**

1. Choisissez la ressource **/\$1proxy\$1\$1**.

1. Choisissez la méthode **ANY**.

1. Sous le symbole d’avertissement, choisissez **Modifier l’intégration**. Vous ne pouvez pas déployer une API dotée d’une méthode sans intégration.

1. Pour **Type d’intégration**, sélectionnez **HTTP**.

1. Activez **Intégration de proxy HTTP**.

1. Pour **Méthode HTTP**, sélectionnez **ANY**.

1. Pour **URL du point de terminaison**, saisissez **http://petstore-demo-endpoint.execute-api.com/\$1proxy\$1**.

1. Choisissez **Enregistrer**.

## Test d’une API avec l’intégration de proxy HTTP
<a name="api-gateway-create-api-as-simple-proxy-for-http-test"></a>

 Indique si la réussite d’une demande client particulière dépend de ce qui suit : 
+  Si le serveur principal a rendu disponible le point de terminaison du serveur principal correspondant et, si tel est le cas, a accordé les autorisations d’accès requises. 
+ Si le client fournit la bonne entrée.

Par exemple, l' PetStore API utilisée ici n'expose pas la `/petstore` ressource. À ce titre, vous obtenez une réponse `404 Resource Not Found` contenant le message d’erreur `Cannot GET /petstore`. 

De plus, le client doit être en mesure de gérer le format de sortie du serveur principal afin de pouvoir analyser le résultat correctement. API Gateway n’intervient pas pour faciliter les interactions entre le client et le backend. 

**Pour tester une API intégrée au PetStore site Web à l'aide de l'intégration d'un proxy HTTP via la ressource proxy**

1. Sélectionnez l’onglet **Test**. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.

1. Pour **Type de méthode**, sélectionnez `GET`.

1. Pour **Chemin**, sous **proxy**, saisissez **petstore/pets**.

1. Pour **Chaînes de requête**, saisissez **type=fish**.

1. Sélectionnez **Tester)**.

     
![\[Utilisez la fonctionnalité de test pour tester une méthode.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/api-gateway-simple-proxy-petstore-call-proxy-resource-new-console.png)

   Comme le site web du serveur principal prend en charge la demande `GET /petstore/pets?type=fish`, il renvoie une réponse positive similaire à ce qui suit :

   ```
   [
     {
       "id": 1,
       "type": "fish",
       "price": 249.99
     },
     {
       "id": 2,
       "type": "fish",
       "price": 124.99
     },
     {
       "id": 3,
       "type": "fish",
       "price": 0.99
     }
   ]
   ```

   Si vous essayez d’appeler `GET /petstore`, vous obtenez une réponse `404` avec le message d’erreur `Cannot GET /petstore`. Cela est dû au fait que le serveur principal ne prend pas en charge l’opération spécifiée. Si vous appelez`GET /petstore/pets/1`, vous obtenez une `200 OK` réponse avec la charge utile suivante, car la demande est prise en charge par le PetStore site Web.

   ```
   {
     "id": 1,
     "type": "dog",
     "price": 249.99
   }
   ```

Vous pouvez utiliser un navigateur pour tester votre API. Déployez votre API et associez-la à une étape pour créer l’URL d’invocation de votre API.

**Pour déployer votre API**

1. Sélectionnez **Deploy API (Déployer une API)**.

1. Pour **Étape**, sélectionnez **Nouvelle étape**.

1. Sous **Stage name (Nom de l’étape)**, entrez **test**.

1. (Facultatif) Sous **Description**, entrez une description.

1. Choisissez **Déployer**.

Les clients peuvent désormais appeler votre API. 

**Pour invoquer votre API**

1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Choisissez votre API.

1. Dans le volet de navigation principal, choisissez **Étape**.

1. Sous **Détails de l’étape**, choisissez l’icône de copie pour copier l’URL d’invocation de votre API.

   Saisissez l’URL d’invocation de votre API dans un navigateur Web. 

   L’URL complète doit ressembler à `https://abcdef123.execute-api.us-east-2.amazonaws.com/test/petstore/pets?type=fish`. 

   Votre navigateur envoie une requête `GET` à l’API.

1. Le résultat doit être identique à celui renvoyé lorsque vous utilisez **Test** depuis la console API Gateway.

# Didacticiel : création d’une API REST avec une intégration HTTP sans proxy
<a name="api-gateway-create-api-step-by-step"></a>

 Dans ce didacticiel, vous créez une API à partir de zéro à l’aide de la console Amazon API Gateway. Vous pouvez envisager la console comme un studio de conception d’API et l’utiliser pour affiner les fonctions d’API, tester ses comportements, créer l’API et la déployer par étapes. 

**Topics**
+ [Création d’une API avec l’intégration HTTP personnalisée](#api-gateway-create-resource-and-methods)
+ [(Facultatif) Mapper les paramètres de requête.](#api-gateway-create-resources-and-methods-next-steps)

## Création d’une API avec l’intégration HTTP personnalisée
<a name="api-gateway-create-resource-and-methods"></a>

 Cette section vous guide tout au long des procédures de création de ressources, d’exposition de méthodes sur une ressource, de configuration d’une méthode pour obtenir les comportements d’API souhaités, et de test et de déploiement de l’API.

Au cours de cette étape, vous créez une API vide. Dans les étapes suivantes, vous allez créer des ressources et des méthodes pour connecter votre API au point de terminaison `http://petstore-demo-endpoint.execute-api.com/petstore/pets`, à l’aide d’une intégration HTTP autre que de proxy. 

**Pour créer une API**

1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Si vous utilisez API Gateway pour la première fois, vous voyez une page qui vous présente les fonctions du service. Sous **REST API (API REST)**, choisissez **Build (Création)**. Lorsque la fenêtre contextuelle **Create Example API (Créer API exemple)** s’affiche, cliquez sur **OK**.

   Si ce n’est pas la première fois que vous utilisez API Gateway, choisissez **Create API (Créer une API)**. Sous **REST API (API REST)**, choisissez **Build (Création)**.

1.  Sous **API name (Nom de l’API)**, saisissez **HTTPNonProxyAPI**.

1. (Facultatif) Sous **Description**, entrez une description.

1. Laissez **Type de point de terminaison d’API** défini sur **Régional**.

1. Pour le **type d'adresse IP**, sélectionnez **IPv4**.

1. Sélectionnez **Create API** (Créer une API).

L’arborescence **Resources** affiche la ressource racine (`/`) sans aucune méthode. Dans cet exercice, nous allons créer l'API avec l'intégration HTTP personnalisée du PetStore site Web (http ://petstore-demo-endpoint.execute-api). com/petstore/pets.) À des fins d'illustration, nous allons créer une `/pets` ressource en tant qu'enfant de la racine et exposer une méthode GET sur cette ressource afin qu'un client puisse récupérer une liste des articles Pets disponibles sur le PetStore site Web.

**Pour créer une ressource /pets**

1. Choisissez **Créer une ressource**.

1. Maintenez **Ressource proxy** désactivée.

1. Conservez **Chemin de la ressource** sous la forme `/`.

1. Sous **Resource Name (Nom de la ressource)**, entrez **pets**.

1. Maintenez **CORS (Partage des ressources entre origines multiples)** désactivé.

1. Choisissez **Créer une ressource**.

Dans cette étape, vous créez une méthode `GET` pour la ressource **/pets**. La méthode `GET` est intégrée avec le site web `http://petstore-demo-endpoint.execute-api.com/petstore/pets`. Les autres options disponibles pour une méthode d’API sont les suivantes :
+ **POST**, principalement utilisée pour créer des ressources enfants.
+ **PUT**, principalement utilisée pour mettre à jour les ressources existantes (et, bien que ce ne soit pas recommandé, peut être utilisée pour créer des ressources enfants).
+ **DELETE**, utilisée pour supprimer des ressources.
+ **PATCH**, utilisée pour mettre à jour les ressources.
+ **HEAD**, principalement utilisée dans les scénarios de test. Cette option est comparable à GET, mais ne renvoie pas la représentation de la ressource.
+ **OPTIONS**, qui peut être utilisée par les appelants pour obtenir des informations sur les options de communication disponibles pour le service cible.

 Dans la liste **HTTP method**, vous devez choisir pour la demande d’intégration une méthode HTTP prise en charge par le backend. Pour `HTTP` ou `Mock integration`, il est logique que la demande de méthode et la demande d’intégration utilisent le même verbe HTTP. Pour les autres types d’intégration, la demande de méthode utilisera probablement un autre verbe HTTP que la demande d’intégration. Par exemple, pour appeler une fonction Lambda, la demande d’intégration doit utiliser `POST` pour appeler la fonction, tandis que la demande de méthode peut utiliser n’importe quel verbe HTTP en fonction de la logique de la fonction Lambda. 

**Pour créer une méthode `GET` dans la ressource **/pets****

1. Sélectionnez la ressource **/pets**.

1. Choisissez **Créer une méthode**.

1. Pour **Type de méthode**, sélectionnez **GET**.

1. Pour **Type d’intégration**, sélectionnez **Intégration HTTP**.

1. Maintenez **Intégration de proxy HTTP** désactivée.

1. Pour **Méthode HTTP**, sélectionnez **GET**.

1. Pour **URL du point de terminaison**, saisissez **http://petstore-demo-endpoint.execute-api.com/petstore/pets**.

   Le PetStore site Web vous permet de récupérer une liste d'`Pet`articles par type d'animal de compagnie, comme « chien » ou « chat », sur une page donnée.

1. Pour **Gestion de contenu**, sélectionnez **Transmettre**.

1. Choisissez **Paramètres de chaîne de requête d’URL**.

   Le PetStore site Web utilise les paramètres de chaîne de `page` requête `type` et pour accepter une entrée. Vous devez ajouter les paramètres de chaîne de requête à la demande de méthode et les mapper aux paramètres de chaîne de requête de la demande d’intégration. 

1. Pour ajouter les paramètres de chaîne de requête, procédez comme suit :

   1. Sélectionnez **Add query string** (Ajouter une chaîne de requêtes).

   1. Pour **Nom**, saisissez **type**

   1. Gardez **Obligatoire** et **Mise en cache** désactivés.

   Répétez les étapes précédentes pour créer une chaîne de requête supplémentaire avec le nom **page**.

1. Choisissez **Créer une méthode**.

Le client peut désormais fournir un type d’animal et un numéro de page comme paramètres de chaîne de requête lorsqu’il envoie une demande. Ces paramètres d'entrée doivent être mappés dans les paramètres de chaîne de requête de l'intégration pour transmettre les valeurs d'entrée à notre PetStore site Web dans le backend.

**Pour mapper les paramètres d’entrée à la requête d’intégration**

1. Dans l’onglet **Requête d’intégration**, sous **Paramètres de requête d’intégration**, choisissez **Modifier**.

1. Choisissez **Paramètres de chaîne de requête d’URL**, puis procédez comme suit : 

   1. Choisissez **Ajouter un paramètre de chaîne de requête d’URL**.

   1. Pour **Nom**, saisissez **type**.

   1. Pour **Mappage à partir de**, saisissez **method.request.querystring.type**.

   1. Maintenez **Mise en cache** désactivée. 

   1. Choisissez **Ajouter un paramètre de chaîne de requête d’URL**.

   1. Pour **Nom**, saisissez **page**.

   1. Pour **Mappage à partir de**, saisissez **method.request.querystring.page**.

   1. Maintenez **Mise en cache** désactivée. 

1. Choisissez **Enregistrer**.

**Pour tester l’API**

1. Choisissez l’onglet **Test**. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.

1. Pour **Chaînes de requête**, saisissez **type=Dog&page=2**.

1. Sélectionnez **Tester)**.

    Le résultat est similaire à ce qui suit :

      
![\[Résultat du test d’appel de la méthode GET sur Pets\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/api-gateway-create-api-step-by-step-test-invoke-get-on-pets-result-new-console.png)

    Maintenant que le test est réussi, nous pouvons déployer l’API pour la rendre disponible publiquement. 

1. Sélectionnez **Deploy API (Déployer une API)**.

1. Pour **Étape**, sélectionnez **Nouvelle étape**.

1. Sous **Stage name (Nom de l’étape)**, entrez **Prod**.

1. (Facultatif) Sous **Description**, entrez une description.

1. Choisissez **Déployer**.

1.  (Facultatif) Sous **Détails de l’étape**, pour **Invoquer une URL**, vous pouvez choisir l’icône de copie pour copier l’URL d’invocation de votre API. Vous pouvez l’utiliser avec des outils tels que [Postman](https://www.postman.com) et [cURL](https://curl.se/) pour tester votre API.

 Si vous utilisez un kit SDK pour créer un client, vous pouvez appeler les méthodes exposées par ce kit SDK pour signer la demande. Pour en savoir plus sur la mise en œuvre, consultez le [kit AWS SDK](https://aws.amazon.com/developer/tools/) de votre choix. 

**Note**  
 Lorsque des modifications sont apportées à votre API, vous devez la redéployer pour rendre les nouvelles fonctions ou celles mises à jour disponibles avant d’appeler à nouveau l’URL de demande. 

## (Facultatif) Mapper les paramètres de requête.
<a name="api-gateway-create-resources-and-methods-next-steps"></a>

### Paramètres de demande de mappage pour une API API Gateway
<a name="getting-started-mappings"></a>

 Ce didacticiel montre comment créer un paramètre de chemin de `{petId}` sur la demande de méthode de l’API pour spécifier un ID d’élément, mapper celui-ci au paramètre de chemin `{id}` dans l’URL de la demande d’intégration, et envoyer la demande au point de terminaison HTTP.

**Note**  
 La saisie d’une lettre majuscule (ou vice versa) peut entraîner des erreurs ultérieurement dans la procédure. 

#### Étape 1 : créer des ressources
<a name="getting-started-mappings-add-resources"></a>

Au cours de cette étape, vous créez une ressource avec un paramètre de chemin \$1petId\$1.

**Pour créer la ressource \$1petId\$1**

1. Sélectionnez la ressource **/pets**, puis choisissez **Créer une ressource**.

1. Maintenez **Ressource proxy** désactivée.

1. Pour **Chemin de ressource**, sélectionnez **/pets/**.

1. Sous **Resource Name (Nom de la ressource)**, entrez **\$1petId\$1**.

    Encadrez `petId` par des accolades (`{ }`) pour afficher **/pets/\$1petId\$1**.

1. Maintenez **CORS (Partage des ressources entre origines multiples)** désactivé.

1. Choisissez **Créer une ressource**.

#### Étape 2 : créer et tester les méthodes
<a name="getting-started-mappings-set-methods"></a>

 Au cours de cette étape, vous créez une méthode `GET` avec un paramètre de chemin `{petId}`. 

**Pour configurer la méthode GET**

1. Sélectionnez la ressource **/\$1petId\$1**, puis choisissez **Créer une méthode**.

1. Pour **Type de méthode**, sélectionnez **GET**.

1. Pour **Type d’intégration**, sélectionnez **Intégration HTTP**.

1. Maintenez **Intégration de proxy HTTP** désactivée.

1. Pour **Méthode HTTP**, sélectionnez **GET**.

1. Pour **URL du point de terminaison**, saisissez **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1**

1. Pour **Gestion de contenu**, sélectionnez **Transmettre**.

1. Maintenez **Délai d’expiration par défaut** activé. 

1. Choisissez **Créer une méthode**.

Vous devez maintenant mapper le paramètre de chemin `{petId}`que vous venez de créer au paramètre de chemin `{id}` dans l’URL du point de terminaison HTTP de la demande d’intégration. L’URL du point de terminaison HTTP était **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1**.

**Pour mapper le paramètre de chemin `{petId}`**

1. Dans l’onglet **Requête d’intégration**, sous **Paramètres de requête d’intégration**, choisissez **Modifier**.

1. Choisissez **Paramètres de chemin d’URL**.

1.  API Gateway crée un paramètre de chemin pour la demande d’intégration nommée **petId**, mais il n’est pas valide pour l’URL du point de terminaison HTTP que vous avez défini comme intégration backend. Le point de terminaison HTTP utilise `{id}` comme paramètre de chemin. Pour **Nom**, supprimez delete **petId** et saisissez **id**.

   Cela mappe le paramètre de chemin `petId` de la demande de méthode au paramètre de chemin `id` de la demande d’intégration.

1. Choisissez **Enregistrer**.

Maintenant, testez la méthode.

**Pour tester la méthode **

1. Choisissez l’onglet **Test**. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.

1. Sous **Chemin** pour **petId**, entrez **4**.

1. Sélectionnez **Test**.

   Si le test aboutit, **Corps de la réponse** affiche les informations suivantes :

   ```
   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }
   ```

#### Étape 3 : déployer l’API
<a name="getting-started-mappings-deploy"></a>

Dans cette étape, vous allez déployer l’API afin de pouvoir commencer à l’appeler en dehors de la console API Gateway.

**Pour déployer l'API**

1. Sélectionnez **Deploy API (Déployer une API)**.

1. Pour **Étape**, sélectionnez **Prod.**

1. (Facultatif) Sous **Description**, entrez une description.

1. Choisissez **Deploy (Déployer)**.

#### Étape 4 : tester l’API
<a name="getting-started-mappings-test"></a>

Dans cette étape, vous allez sortir de la console API Gateway et utiliser votre API pour accéder au point de terminaison HTTP.

1. Dans le volet de navigation principal, choisissez **Étape**.

1. Sous **Détails de l’étape**, choisissez l’icône de copie pour copier l’URL d’invocation de votre API.

   Elle doit se présenter comme suit :

   ```
   https://my-api-id.execute-api.region-id.amazonaws.com/prod
   ```

1. Entrez cette URL dans la zone d’adresse d’un nouvel onglet du navigateur et ajoutez `/pets/4` à l’URL avant d’envoyer votre requête.

1. Le navigateur retourne ce qui suit :

   ```
   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }
   ```

#### Étapes suivantes
<a name="api-gateway-create-resources-and-methods-next-steps"></a>

Vous pouvez personnaliser davantage votre API en activant la validation des requêtes, en transformant les données ou en créant des réponses de passerelle client. 

Pour découvrir d’autres moyens de personnaliser votre API, consultez les didacticiels suivants :
+ Pour plus d’informations sur la validation de demande, consultez [Configuration de la validation de demande de base dans API Gateway](api-gateway-request-validation-set-up.md).
+ Pour plus d’informations sur la transformation des charges utiles de requête et de réponse, consultez [Tutoriel : Modifier la demande et la réponse d'intégration pour les intégrations aux services AWS](set-up-data-transformations-in-api-gateway.md).
+ Pour plus d’informations sur la création d’une passerelle client, consultez [Configurer une réponse de passerelle pour une API REST à l’aide de la console API Gateway](set-up-gateway-response-using-the-console.md).