用于下载zip文件的swagger规范的正确媒体类型

Question

我正在创建一个允许下载zip文件的api，因此为此，我正在寻找正确的媒体类型，以便在swagger“2.0”规范中发送此zip文件作为响应。

我当前的api规范如下所示

/config:
  get:
    produces:
      - application/zip
    responses:
        200: # OK
          description: All config files
          schema:
            type: string
            format: binary

我已经用“go-swagger”编译了这个规范并为此实现了后端，但是当尝试调用这个API时，我得到了这个错误

http: panic serving 127.0.0.1:20366: applicationZip producer has not yet been implemented

在swagger的文档中，我没有看到这种媒体类型

官方招摇的媒体类型

那么，如果我们想提供一个API来下载zip文件，那么正确的媒体类型应该是什么呢。提前感谢

Answer 1

您应该使用“应用程序/八位流”来实现将文件作为附件下载的api，并且由于其生产者已经默认实现，因此您不会遇到这个问题。

Answer 2

您需要实现这一点。

由于以下生成的代码而发生此错误：

func NewSampleAPI(spec *loads.Document) *SampleAPI {
    return &SampleAPI{
    ...
        ApplicationZipProducer: runtime.ProducerFunc(func(w io.Writer, data interface{}) error {
            return errors.NotImplemented("applicationZip producer has not yet been implemented")
        }),

因此，在调用＜code＞NewSampleAPI：

golang prettyprint-override">api := operations.NewSampleAPI(swaggerSpec)
api.ApplicationZipProducer = func(w io.Writer, data interface{}) error {
    ...
}