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

Question

我希望熟悉Amazon Connect API。我已经看到了下面的参考资料，但对我来说很难使用，因为导航是一个按操作而不是资源排序的扁平的、按字母顺序排列的endpoint列表。值得注意的是，endpoint以“Delete”、“Get”、“List”、“Update”等字母开头，而最好按资源分组。

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

我使用以下API参考：

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

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

OpenAPI

我们建议使用OpenAPI和基于OpenAPI的工具来处理Google的RESTAPI。已经发布了几种将Google Discovery格式转换为OpenAPI的工具：

• google discovery to swagger，一个麻省理工学院许可的开源脚本，用于将google discovery格式转换为swagger 2.0
• API规范转换器，LucyBot的在线转换器
• APIMatic的API Transformer

谷歌的OpenAPI工具包括gnostic，它是OpenAPI工具的前端，用于读取OpenAPI描述，将其放入有效的二进制表示中，并允许使用任何编程语言轻松编写高效插件和独立工具，并支持协议缓冲区。

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

更新：Aossey注意到Amazon没有为他们的API发布OpenAPI规范。为了解决这个问题，我已经开始在下面的repo中收集一些信息，可能会产生一个OpenAPI规范。请随意贡献。

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

Answer 1

简而言之，答案是否定的，这些API没有OpenAPI规范。

这些功能（在您链接的文档中列出）在AWS SDK和AWS CLI中实现。虽然存在底层HTTPendpoint，但它们不容易以您最可能寻找的方式使用。SDK和CLI为您提供身份验证/授权（通过IAM服务）和请求签名，如果您要直接利用endpoint，则必须自己实现。