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.

# Utilisation de la console API Gateway pour tester une méthode API REST
<a name="how-to-test-method"></a>

Utilisez la console API Gateway pour tester une méthode API REST.

**Topics**
+ [Prérequis](#how-to-test-method-prerequisites)
+ [Test d’une méthode avec la console API Gateway](#how-to-test-method-console)

## Prérequis
<a name="how-to-test-method-prerequisites"></a>
+ Vous devez spécifier les paramètres des méthodes que vous souhaitez tester. Suivez les instructions de la section [Méthodes pour REST APIs dans API Gateway](how-to-method-settings.md).

## Test d’une méthode avec la console API Gateway
<a name="how-to-test-method-console"></a>

**Important**  
Le test des méthodes avec la console API Gateway peut entraîner des modifications de ressources impossibles à annuler. Tester une méthode avec la console API Gateway revient à appeler la méthode en dehors de la console API Gateway. Par exemple, si vous utilisez la console API Gateway pour appeler une méthode qui supprime les ressources d’une API, si l’appel de la méthode aboutit, les ressources de l’API sont supprimées.

**Pour tester une méthode**

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

1. Choisissez une API REST.

1. Dans le volet **Resources**, sélectionnez la méthode à tester.

1. Choisissez l’onglet **Test**. Vous devrez peut-être choisir la flèche droite pour afficher l’onglet.  
![\[Utilisez l’onglet Test pour tester votre API. Il se trouve à côté de l’onglet Réponse de méthode.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/api-gateway-test-new-console.png)

    Entrez des valeurs dans les zones affichées (par exemple, **Chaînes de requête**, **En-têtes** et **Corps de la demande**). La console inclut ces valeurs dans le formulaire application/json par défaut de la demande de méthode.

   Pour obtenir des options supplémentaires, vous devrez peut-être spécifier ou contacter le propriétaire de l’API.

1. Sélectionnez **Test**. Les informations suivantes s’affichent alors :
   + **Request** est le chemin de la ressource qui a été appelée pour la méthode.
   + **Status** est le code de statut HTTP de la réponse.
   + **Latence (ms)** correspond au temps écoulé entre la réception de la demande de l’appelant et l’envoi de la réponse.
   + **Corps de la réponse** correspond au corps de la réponse HTTP.
   + Le paramètre **En-têtes de réponse** correspond aux en-têtes de réponse HTTP.
**Astuce**  
Selon le mappage, le code de statut HTTP, le corps de la réponse et les en-têtes de réponse peuvent être différents de ceux envoyés depuis la Fonction Lambda, un proxy HTTP ou un proxy de service AWS.
   + Les valeurs **Logs (Journaux)** correspondent aux entrées Amazon CloudWatch Logs simulées qui auraient été écrites si cette méthode avait été appelée en dehors de la console API Gateway.
**Note**  
Bien que les entrées CloudWatch Logs soient simulées, les résultats de l’appel de la méthode sont réels.

 En plus de la console API Gateway, vous pouvez utiliser la AWS CLI ou un kit AWS SDK pour API Gateway afin de tester l’appel d’une méthode. Pour utiliser l’AWS CLI, consultez la section [test-invoke-method](https://docs.aws.amazon.com/cli/latest/reference/apigateway/test-invoke-method.html).