2016年4月5日，Amazon宣布更新其API管理服務Amazon API網(wǎng)關(guān)。經(jīng)過此次更新，Amazon API網(wǎng)關(guān)現(xiàn)在支持直接導入Swagger 2.0的API定義了。

Swagger是一種規(guī)范，允許開發(fā)人員使用一種通用描述語言表示REST API。開發(fā)人員可以使用swagger編輯器設計REST API，作為這種體驗的一部分，文檔和元數(shù)據(jù)也會通過工具顯示出來。使用Swagger定義可以創(chuàng)建模擬測試客戶端和面向多種語言的SDK，包括Java、JavaScript、Ruby、PHP和C#，這可以為想要使用你的API的組織縮短開發(fā)周期。

自Amazon API網(wǎng)關(guān)服務推出以來，Swagger就是它支持的一種API規(guī)范。但是，開發(fā)人員之前需要使用Swagger導入工具將Swagger定義導入到API網(wǎng)關(guān)。Swagger導入工具可以從GitHub上下載，它提供了一種命令行工具體驗：

圖片來源：http://swagger.io/getting-started-with-the-amazon-swagger-importer/

今后，開發(fā)人員可以使用AWS管理控制臺、命令行接口（CLI）或SDK。開發(fā)人員可以在AWS管理控制臺上進行如下操作：

圖片來源：http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-from-example.html

到今年1月1日，Swagger規(guī)范已經(jīng)捐獻給Open API Initiative（OAI）。OAI意在將對標準化REST API描述感興趣的組織團結(jié)在一起。OAI在Linux基金會下以一個開放的治理結(jié)構(gòu)運營，其成員包含許多行業(yè)領(lǐng)導者，包括Google、Apigee、Atlassian、IBM、Intuit、Microsoft、PayPal等等。

Swagger并不是Amazon API網(wǎng)關(guān)唯一支持的一種API規(guī)范。該服務還支持一種與其存在競爭關(guān)系的規(guī)范RAML。在本文寫作的時候，Amazon已經(jīng)指出，“使用RAML定義的客戶當前應該繼續(xù)使用aws-apigateway-importer。”RAML是由Mulesoft領(lǐng)導的一個開放的工作組，獲得了包括Cisco（Mulesoft投資人之一）、VMWare和Akana在內(nèi)的其他成員的支持。

查看英文原文：Amazon API Gateway Now Supports Swagger Definition Import