Amazon Connect API 是否有 OpenAPI 或其他 API 规范?

Is there an OpenAPI or other API Specification for the Amazon Connect API?

我希望熟悉 Amazon Connect API。我看过下面的参考资料,但它对我来说很难使用,因为导航是一个平面的、按字母顺序排列的端点列表,按操作而不是资源排序。值得注意的是,端点按字母顺序排列,以“删除”、“获取”、“列表”、“更新”等开头,而将这些端点按资源分组会很棒。

我想重新组织文档,这可以通过编辑 OpenAPI 或其他 API 规范并为每个操作添加标签来完成。我查看了参考资料并进行了几次搜索但未成功。

我正在使用以下 API 参考:

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

任何其他规范格式,如 RAML 或专有格式也可以。例如,Google 提供了他们自己的“Google 发现格式”,可以将其转换为 OpenAPI。以下内容在 https://googleapis.github.io/ .

中提到

OpenAPI

We recommend using OpenAPI and OpenAPI-based tools for working with Google’s REST APIs. Several tools for converting Google Discovery Format to OpenAPI have been published:

  • google-discovery-to-swagger, an MIT-licensed open source script for converting Google Discovery format into Swagger 2.0.
  • API Spec Converter, an online converter from LucyBot.
  • The API Transformer from APIMatic.

Google’s OpenAPI tools include gnostic, a front-end for OpenAPI tools that reads OpenAPI descriptions, puts them in an efficient binary representation, and allows efficient plugins and standalone tools to be easily written in any programming language with Protocol Buffer support.

是否有 OpenAPI 或其他可用于此 API 的规范?如果有,我想用标签更新它,然后以更易于使用的格式呈现它。

更新:Aossey 注意到亚马逊没有发布其 API 的 OpenAPI 规范。为了解决这个问题,我已经开始 assemble 下面 repo 中的一些信息,可能会导致 OpenAPI 规范。欢迎贡献。

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

简短的回答是否定的,没有针对这些 API 的 OpenAPI 规范。

这些功能(在您链接的文档中列出)在 AWS SDK and the AWS CLI. While there are underlying HTTP endpoints, they are not easily consumable in the way you're most likely looking for. The SDK and CLI take care of authentication/authorization (via IAM service) 中实现并请求为您签名,如果您要直接利用端点,则必须自己实现。