用于邮递员的 NestJs Swagger

Question

有没有办法将生成的 swagger.json 作为集合导入到 Postman 中？

我尝试导入它，但端点未显示在 Postman 中？

我正在使用 NestJs 和 Swagger + Postman

Answer 1

在 main.ts 中设置 swagger 时（请参阅此处的文档：NestJs Swagger Docs），您可以添加.setExternalDoc('Postman Collection', '/your-api-docs-url-with-the-word-json-at-the-end'). 这会在文件顶部提供一个链接，以便您可以单击以获取可导入的 JSON。

这是我的一个例子：

const document = SwaggerModule.createDocument(
    app,
    new DocumentBuilder()
      .setTitle('Nest Api')
      .setDescription('MyNestApiDescription')
      .setVersion('1.0')
      .addBearerAuth()
      .setExternalDoc('Postman Collection', '/docs-json')
      .build(),
  );
  SwaggerModule.setup('/docs', app, document);

正如你所看到的，我的 API 文档位于，'/docs'所以我的 json url 很简单'/docs-json'。

有关如何将其导入 Postman 的信息，请参阅此 stackoverflow 帖子：Postman JSON Docs Import