4

我正在使用 swagger-api 和 swagger-editor 为路由开发一个 RESTful API。我无法弄清楚为什么我通过正文发送的 JSON 从未到达我的控制器。这是我的 YAML

  schemes:
  - http
  - https

produces: [application/json, multipart/form-data, application/x-www-form-urlencoded]

paths:
 /projects:
    x-swagger-router-controller: project
    post:
      description: create a new project
      operationId: postProjects
      consumes:
        - application/json
      parameters:
        - name: param1
          in: body
          description: description
          required: false
          schema:
            $ref: "#/definitions/Project" 
      responses:
        "200":
          description: Success
          schema:
            $ref: "#/definitions/Project" 
        default:
          description: Error
          schema: 
            $ref: "#/definitions/ErrorResponse"

definitions:
  Project:
    properties:
      name:
       type: string
    required:
      - name

我正在发送的发布请求的示例。

curl -v -X POST -H "Content-Type: application/json" -d '{"name":"test"}' http://127.0.0.1:10010/projects

和回应

{"message":"Request validation failed: Parameter (param1) failed schema validation","code":"SCHEMA_VALIDATION_FAILED","failedValidation":true,"results":{"errors":[{"code":"OBJECT_MISSING_REQUIRED_PROPERTY","message":"Missing required property: name","path":[]}],"warnings":[]},"path":["paths","/projects","post","parameters","0"],"paramName":"param1"}

如果我将参数“name”设置为不需要，我只会收到一个像这样的空响应 { param1: { path: [ 'paths', '/projects', 'post', 'parameters', '0' ], schema : { name: 'param1', in: 'body', description: 'description', required: false, schema: [Object] }, originalValue: {}, value: {} } } 我不知道为什么因为其他格式例如标题、路径或表单数据工作正常。我总是收到一个空对象。req.swagger.params没有价值。我尝试了几种模式，但即使是最简单的也不起作用。我可以从标题中看出“内容类型”：“应用程序/json”。因此设置了内容类型，架构验证了一个名为“

4

2 回答 2

0

这个问题已被解决。这与招摇无关。我用 nodeJs 构建了一个 API，我意识到我没有一个中间件来处理 body 参数。所以因为我在启用 swagger 中间件之前错过了一步，所以我无法对 body 参数做任何事情。

于 2016-09-23T10:06:28.467 回答
0

将 json 数据发送到 API 后端时获得空值的主要原因是您在大多数情况下提供的参数路径以及您为参数提供的命名。

您还必须明确声明您期望的模式类型

您必须将参数名称设置为body并设置in: body，以便它选择正文对象作为 JSON

一个例子是here。你可以试试看

/auth/register:
    post:
      tags:
        - Auth
      parameters:
        - in: body
          name: user
          description: Create a new user.
          schema:
            type: object
            required:
              - firstName
              - lastName
              - email
              - password
              - confirmPassword
            properties:
              firstName:
                type: string
              lastName:
                type: string
              email:
                type: string
              password:
                type: string
              confirmPassword:
                type: string
            example:
              firstName: Jane
              lastName: Doe
              email: janedoe@gmail.com
              password: pass
              confirmPassword: pass
      responses:
        "200":
          description: OK
于 2021-12-19T09:48:29.113 回答