记录 REST API - Amazon API Gateway
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

记录 REST API

为帮助客户了解和使用您的 API，您应记录 API。为帮助您记录 API，API Gateway 支持您为各个 API 实体添加和更新帮助内容，这是 API 开发流程中不可或缺的一部分。API Gateway 将存储源内容，并使您能够存档不同版本的文档。您可以将一个文档版本与一个 API 阶段关联，将特定于阶段的文档快照导出为外部 OpenAPI 文件，并将该文件以文档发布的形式分发。

要记录您的 API，您可以调用 API Gateway REST API，使用适用于 API Gateway 的某种 Amazon SDKs 或 Amazon CLI，或使用 API Gateway 控制台。此外，您还可以导入或导出在外部 OpenAPI 文件中定义的文档部分。

要与开发人员共享 API 文档，您可以使用开发人员门户。有关示例，请参阅 Amazon 合作伙伴网络 (APN) 博客上的 Integrating ReadMe with API Gateway to Keep Your Developer Hub Up to Date（将 ReadMe 与 API Gateway 集成，让您的开发人员中心保持最新状态）。

主题