【问题标题】:Sails swagger api documentationSails 招摇 api 文档
【发布时间】:2023-03-11 06:51:02
【问题描述】:

我在我的节点 js 应用程序中使用sails。并想实现swagger api文档。我关注Swagger Sails JS 文件。我从我的api doc 得到了结果。我的预期结果来自 api doc 。我已经在 router.js 文件中写了路由,如下所示

'post /login': {
    controller: 'user/UserController',
    action: 'login',
    skipAssets: 'true',
    //swagger path object
    "get": {
      "tags": [
        "Users"
      ],
      "description": "Get a login user data",
      "parameters": [{
        "email": "abc@gmail.com",
        "password": "12345678y",
        "deviceToken": "12345678y",
        "deviceType": 2
      }],
      "responses": {
        "200": {
          "statusCode": 0,
          "status": true,
          "message": "string",
          "result": {}
        }
      }
    }
  }

如果我的路线写错了。那么如何编写路由,以便我从 api docs 获得预期的结果?

谢谢!

【问题讨论】:

    标签: node.js sails.js swagger swagger-ui sails-mongo


    【解决方案1】:

    您可以尝试使用this

    我想路由器文件应该是这样的:

    'post /login': {
        controller: 'user/UserController',
        action: 'login',
        skipAssets: 'true',
        swagger: {
            methods: ["get"],
            tags: ["Users"],
            description: "Get a login user data",
            parameters: [{
                email: "abc@gmail.com",
                password: "12345678y",
                deviceToken: "12345678y",
                deviceType: 2
            }],
            responses: {
                '200': {
                    statusCode: 0,
                    status: true,
                    message: "string",
                    result: {}
                }
            }
        }
    }
    

    【讨论】:

    • 我更改了路线,但 API 文档中没有任何更改。
    猜你喜欢
    • 2020-11-23
    • 2016-02-23
    • 1970-01-01
    • 2017-12-24
    • 2021-02-03
    • 2020-07-19
    • 1970-01-01
    • 1970-01-01
    • 2020-07-02
    相关资源
    最近更新 更多