小编sdg*_*sdg的帖子

在Swagger中,如何定义使用文件以及模式参数的API?

我正在尝试使用Swagger定义一个接受实际文件的API和一个描述文件内容的架构对象。这是Swagger YAML的片段。但是,它不会在Swagger编辑器中验证。

/document:
  post:
    summary: Api Summary
    description: Api Description
    consumes:
      - multipart/form-data
    parameters:
      - name: documentDetails
        in: formData
        description: Document Details
        required: true
        schema:
          $ref: '#/definitions/Document'
      - name: document
        in: formData
        description: The actual document
        required: true
        type: file
Run Code Online (Sandbox Code Playgroud)

Swagger编辑器会引发以下验证错误:

Swagger错误:数据与“ oneOf”中的任何架构都不匹配

我想念什么吗?还是这不是Swagger支持的功能?

swagger swagger-2.0 openapi

5
推荐指数
1
解决办法
4477
查看次数

标签 统计

openapi ×1

swagger ×1

swagger-2.0 ×1