Articles of 大摇大摆

大招:requestBody不允许

我试图用swagger定义一个post端点,但是它不允许requestBody参数: /names/{roster}: get: #… post: x-swagger-router-controller: names description: Adds or removes name(s) operationId: manageNames parameters: – name: roster in: path description: the roster to use type: string required: true requestBody: content: 'application/json': schema: $ref: '#/definitions/ManageNamesRequest' 当我运行npm start ,我得到这个: API Errors: #/paths/~1names~1{roster}/post: Additional properties not allowed: requestBody 1 error and 0 warnings 我的规范有什么问题?

与正常路线一起使用Swagger Express

我有兴趣使用像swagger-node-express这样的东西为我正在开发的项目构buildAPI。 但是,该应用程序的某些部分是非基于API(改为提供HTML)。 有没有人有任何想法,我将如何使用Swagger旁边的正常路线?

在swagger节点请求中,默认值在哪里显示?

我有以下路线: /myroute: x-swagger-router-controller: myroute post: operationId: createSomething parameters: – name: payload in: body required: true schema: type: object properties: somedefault: type: string default: teststring 并在我的createSomething函数我试图控制台日志值: console.log(req.swagger.params.payload.value) ,我期望看到 {somedefault: 'teststring'} 但是我没有看到一些somedefault 。 我误解了默认参数在swagger-node中显示的位置?

为现有NodeJS服务器生成Swagger文档

根据Swagger网站 ,有两种方法:自下而上和自上而下。 我有一个现有的NodeJS服务器,我想在Azure环境中部署,需要一个swagger文档(API APP)。 有没有人知道使用代码生成招摇的工具? 更好的是,如果你能指出一个教程。 我无法find它。