招摇 CSV 帖子答案

【问题标题】：Swagger CSV Post招摇 CSV 帖子
【发布时间】：2018-07-20 18:03:42
【问题描述】：

我们正在为我们的 Laravel REST API 实现编写 Swagger 文档。一些 POST 端点将使用 CSV 作为参数内容类型。

Swagger 中有没有办法让“立即尝试”功能与 CSV POST 文件上传一起使用？

以下是我们正在进行的文档 http://api.curvecompass.com/docs/#/

我们的 Laravel POST 函数可以在 CSV 端点上正常工作，而不是 Swagger 文档。

【问题讨论】：

stackoverflow.com/questions/14455408/… 是否为您指明了正确的方向？
您使用的是 Swagger 2.0 还是 Swagger 3.0？
@TarunLalwani 3.0
澄清一下 - 您的意思是 1) 操作消耗 Content-Type: text/csv 并且响应正文是格式为 CSV 的文本； 2) 一个操作是一个文件上传请求 (multipart/form-data)，它需要一个 CSV 文件作为多部分有效负载的一部分？
@Helen 目前我们使用 Laravel - 我们构建了一个端点，它接受一个包含 CSV 数据的 HTML POST 文件。我们想在 Swagger 文档中添加“立即尝试”功能，该功能将接受 CSV 文件到表单数据中，并将其传递到 Laravel 端点以供摄取。

标签： laravel csv swagger swagger-ui swagger-php

【解决方案1】：

swagger ui for open api 3.0 尚不支持文件上传。你可以在这里观看更新https://github.com/swagger-api/swagger-ui/issues/3641

【讨论】：

那太臭了。在这一点上，如果有人可以提供，我愿意接受黑客攻击。否则我只会自己破解它。感谢您的信息。

【解决方案2】：

你可以试试这个。

consumes:
    - multipart/form-data  # and/or application/x-www-form-urlencoded
  parameters:
    - name: file
      in: formData
      description: The uploaded file data
      required: true
      type: file

【讨论】：