Amazon Connect API 是否有 OpenAPI 或其他 API 規范？

Question

我希望熟悉 Amazon Connect API。 我已經看過下面的參考資料，但對我來說很難使用，因為導航是按操作而不是資源排序的端點的扁平字母列表。 值得注意的是，端點按字母順序以“刪除”、“獲取”、“列表”、“更新”等開頭，而將這些按資源分組會很棒。

我想重新組織可以通過編輯 OpenAPI 或其他 API 規范並為每個操作添加標簽來完成的文檔。 我查看了參考資料並進行了幾次搜索，但均未成功。

我正在使用以下 API 參考：

https://docs.aws.amazon.com/connect/latest/APIReference

任何其他規范格式，例如 RAML 或專有格式也可以。 例如，Google 提供了自己的“Google Discovery Format”，可以轉換為 OpenAPI。 以下在https://googleapis.github.io/中提到。

開放API

我們建議使用 OpenAPI 和基於 OpenAPI 的工具來處理 Google 的 REST API。 已經發布了幾個將 Google Discovery Format 轉換為 OpenAPI 的工具：

• google-discovery-to-swagger，一個 MIT 許可的開源腳本，用於將 Google Discovery 格式轉換為 Swagger 2.0。
• API 規格轉換器，來自 LucyBot 的在線轉換器。
• APIMatic 的 API 變壓器。

Google 的 OpenAPI 工具包括 gnostic ，它是OpenAPI工具的前端，它讀取 OpenAPI 描述，將它們置於高效的二進制表示中，並允許使用任何支持 Protocol Buffer 的編程語言輕松編寫高效的插件和獨立工具。

此 API 是否有可用的 OpenAPI 或其他規范？ 如果有，我想用標簽更新它，然后以更容易使用的格式呈現它。

更新： Aossey指出亞馬遜沒有為其 API 發布 OpenAPI 規范。 為了解決這個問題，我開始在下面的 repo 中收集一些信息，可能會產生一個 OpenAPI 規范。 隨意貢獻。

https://github.com/grokify/amazon-api-specs/blob/master/connect/endpoints.csv

Answer 1

簡短的回答是否定的，這些 API 沒有 OpenAPI 規范。

這些功能（在您鏈接的文檔中列出）在AWS SDK和AWS CLI中實現。 雖然有底層 HTTP 端點，但它們並不容易以您最可能尋找的方式消耗。 SDK 和 CLI 負責身份驗證/授權（通過IAM 服務）並為您請求簽名，如果您要直接利用端點，則必須自己實現。