当我将Swagger API导入Postman时，所有请求名称在Postman GUI中最终都为空白

Question

我是质量检查工程师。开发团队使用Swagger为我们产品的RESTful API生成文档。我需要将其导入Postman，以轻松调用产品的API。

将JSON文件（以Swagger格式）导入Postman后，存在1个但很大的问题：单个请求的所有标题（和描述）都是空白！（请参见下面的屏幕截图）。

显然，这是一个已知问题，在此处记录：https : //github.com/postmanlabs/postman-app-support/issues/1434

我们实际上有数百个请求。我需要找到一种有效而又简单的方法，以确保Postman中的所有请求标题都填充有一个我想即时计算的值。

我一直在考虑以下方法：

编写命令行工具（使用NodeJS或其他可靠平台），该工具将收到：1.要修复的集合的ID 2. api密钥

它将遍历集合中的所有请求。对于每个请求：如果“名称”字段为空白，则请求URL的子字符串将分配给“名称”字段；如果名称不为空，则该请求将保留。

我不确定的是：

1. 我可以通过邮递员以编程方式进行此操作吗？将此代码放入任何一个单独的请求中（作为之前或之后）是没有意义的。

（如果我必须在Postman之外编写此util的代码）

2. 对于NodeJS，有“ postman-collection”和“ postman-sdk”，但我有些困惑，应该使用。

3. 不幸的是，我还没有找到合适的库来使用C＃或Java维护Postman集合。

坦白地说，我对可用的选项感到困惑。任何指导将不胜感激。

Answer 1

对此的一个简单答案是添加一行summary: <RequestName>

我使用优秀的APIs-Gurus OpenAPIDirectory 存储库遇到了这个问题

这些 swagger.yaml 文件有operationId:一行可以复制，并将密钥替换为summary:使用：

awk '{if (!/      operationId:/) {print ; next} ; { print; a=gensub(/      operationId:/, "      summary:",1) ; print a}}' swagger.yaml  > swagger-new.yaml

将其导入 Postman 然后会显示正确的请求名称。

PostMan 将导入/导出功能分离为单独的插件，但其插件模型目前还有很多不足之处。