

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.

# Documentation pour REST APIs dans API Gateway
<a name="api-gateway-documenting-api"></a>

 Pour aider les clients à comprendre et à utiliser votre API, vous devez documenter cette dernière. Pour vous aider à documenter votre API, API Gateway vous permet d’ajouter et de mettre à jour le contenu de chaque entité de l’API dans le cadre du processus de développement de l’API. API Gateway stocke le contenu source et vous permet d’archiver différentes versions de la documentation. Vous pouvez associer une version de la documentation à une étape de l’API, exporter un instantané de la documentation propre à une étape donnée dans un fichier OpenAPI externe et distribuer le fichier sous forme de publication de la documentation. 

Pour documenter votre API, vous pouvez appeler l'[API REST API Gateway](https://docs.aws.amazon.com/apigateway/latest/api/), utiliser l'une des API [AWS SDKs](https://aws.amazon.com/developer/tools/), utiliser l'[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/apigateway/)API Gateway ou utiliser la console API Gateway. En outre, vous pouvez importer ou exporter les parties de la documentation définies dans un fichier OpenAPI externe.

Pour partager la documentation de l’API avec les développeurs, vous pouvez utiliser un portail pour développeurs. Par exemple, consultez [Integrating ReadMe with API Gateway to keep your Developer Hub à jour](https://aws.amazon.com/blogs/apn/integrating-readme-with-amazon-api-gateway-to-keep-your-developer-hub-up-to-date/) ou [How to Streamline API Development on Amazon API Gateway en utilisant SmartBear](https://aws.amazon.com/blogs/apn/how-to-streamline-api-development-on-amazon-api-gateway-using-smartbear-swaggerhub/) le blog SwaggerHub on the AWS Partner Network (APN).

**Topics**
+ [Représentation de la documentation de l’API dans API Gateway](api-gateway-documenting-api-content-representation.md)
+ [Documentation d’une API avec la console API Gateway](api-gateway-documenting-api-quick-start-with-console.md)
+ [Publication de la documentation de l’API à l’aide de la console API Gateway](apigateway-documenting-api-with-console.md)
+ [Documentation d’une API en utilisant l’API REST API Gateway](api-gateway-documenting-api-quick-start-with-restapi.md)
+ [Publication de la documentation de l’API à l’aide de l’API REST](api-gateway-documenting-api-quick-start-publishing.md)
+ [Importation de la documentation d’une API](api-gateway-documenting-api-quick-start-import-export.md)
+ [Contrôle de l’accès à la documentation de l’API dans API Gateway](api-gateway-documenting-api-content-provision-and-consumption.md)