问询:Amazon Connect API是否提供OpenAPI或其他API规范用于重组文档
Amazon Connect API 规范相关问题说明
现存文档使用痛点
官方提供的Amazon Connect API参考文档采用扁平导航结构,所有端点按Delete/Get/List/Update等操作开头的字母顺序排序,未按资源维度分组,使用便利性较差。
需求说明
希望获取Amazon Connect对应的OpenAPI、RAML、Google Discovery Format等可转换、可自定义标签的API规范,通过为每个操作添加标签的方式重组文档导航,解决当前官方文档使用便利性不足的问题。
核心问询结论
亚马逊官方未公开Amazon Connect API的可直接复用的标准化API描述规范。
可复用的API处理工具
- 支持Google Discovery格式转OpenAPI的工具:
google-discovery-to-swagger:MIT许可开源脚本,可将Google Discovery格式转换为Swagger 2.0- API Spec Converter:LucyBot提供的在线转换工具
- API Transformer:APIMatic提供的转换工具
- OpenAPI生态工具:
gnostic:OpenAPI工具链前端,可读取OpenAPI描述并转为高效二进制表示,支持基于Protocol Buffer开发快速运行的插件与独立工具
替代解决方案
目前已整理完成Amazon Connect全端点明细清单,可基于该清单自行构建OpenAPI规范,后续可通过自定义标签实现按资源分组的文档导航,相关构建工作欢迎贡献。
内容的提问来源于stack exchange,提问作者Grokify
相关产品推荐
相关产品推荐

