# API Gateway での REST API のドキュメント
<a name="api-gateway-documenting-api"></a>

 顧客が API について理解して使いやすくするため、API をドキュメント化してください。API をドキュメント化しやすいように、API Gateway では API 開発プロセスの不可欠な部分として個々の API エンティティのヘルプコンテンツを追加および更新できます。API Gateway にはソースコンテンツが保存され、さまざまなバージョンのドキュメントをアーカイブできます。ドキュメントバージョンと API ステージを関連付けたり、ステージ固有のドキュメントスナップショットを外部 OpenAPI ファイルにエクスポートしたり、ファイルをドキュメントの出版物として配布したりすることができます。

API をドキュメント化するには、[API Gateway REST API](https://docs.aws.amazon.com/apigateway/latest/api/) を呼び出すか、[AWS SDK](https://aws.amazon.com/developer/tools/) のいずれかを使用するか、API Gateway 用の [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/apigateway/) を使用するか、API Gateway コンソールを使用できます。加えて、外部 OpenAPI ファイルで定義されたドキュメントパーツをインポートまたはエクスポートすることができます。

API ドキュメントをデベロッパーと共有するには、デベロッパーポータルを使用できます。例については、AWS パートナーネットワーク (APN) ブログの「[Developer Hub を最新の状態に保つための ReadMe と API Gateway の統合](https://aws.amazon.com/blogs/apn/integrating-readme-with-amazon-api-gateway-to-keep-your-developer-hub-up-to-date/)」または「[SmartBear の SwaggerHub を使用して Amazon API Gateway での API 開発を効率化する方法](https://aws.amazon.com/blogs/apn/how-to-streamline-api-development-on-amazon-api-gateway-using-smartbear-swaggerhub/)」を参照してください。

**Topics**
+ [API Gateway での API ドキュメントの表現](api-gateway-documenting-api-content-representation.md)
+ [API Gateway コンソールを使用して API を文書化する](api-gateway-documenting-api-quick-start-with-console.md)
+ [API Gateway コンソールを使用して API ドキュメントを公開する](apigateway-documenting-api-with-console.md)
+ [API Gateway REST API を使用して API を文書化する](api-gateway-documenting-api-quick-start-with-restapi.md)
+ [API Gateway REST API を使用した API ドキュメントを公開する](api-gateway-documenting-api-quick-start-publishing.md)
+ [API ドキュメントのインポート](api-gateway-documenting-api-quick-start-import-export.md)
+ [API Gateway で API ドキュメントへのアクセスを制御する](api-gateway-documenting-api-content-provision-and-consumption.md)