Amazon API Gateway
開発者ガイド

API Gateway での REST API のドキュメント化

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

API をドキュメント化するには、API GatewayREST API を呼び出す、AWSSDK や API Gateway 用の AWS CLI のいずれかを使用する、または API Gateway コンソールを使用することができます。加えて、外部 OpenAPI ファイルで定義されたドキュメントパーツをインポートまたはエクスポートすることができます。API をドキュメント化する方法を説明する前に、API ドキュメントが API Gateway でどのように表現されるかを示します。