swagger - 这个 OpenAPI/Swagger 规范是什么意思？

Question

有问题的规范:

openapi: '3.0.2'
info:
  title: Video Storage Server API
  version: '1.0'
servers:
  - url: http://localhost:8080
paths:
  /files/{fileid}:
    get:
      description: Download a video file by fileid. 
      parameters:
        - in: path
          name: fileid
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          headers:
            Content-Disposition:
              schema:
                type: string
          content:
            video/mp4:  # foo.mp4
              schema: 
                type: string
                format: binary
            video/mpeg: # bar.mpg 
              schema:
                type: string
                format: binary

我知道我需要让我的服务器响应带有 fileid 的 get 请求。服务器存储视频。

来自服务器的响应，应该是用户可以在浏览器/Postman 中播放的视频还是应该是视频的字节数组？

即响应应该是:

或

此外，content#video/mp4/content#video/mpeg 是什么意思？我是否需要在我的回复中将 content-type 设置为这两个之一？

我的 Content-Disposition 应该是什么？

Answer 1

答案是第一个示例中的视频，或者更准确地说是对应于请求的内容类型的字节流，video/mp4 或 video/mpeg ，带有 Content-Disposition header 。

如果响应是像第二个示例中那样的 JSON block ，则响应内容类型将是 application/json(或等效的)，并且它将显式列出响应对象模式，即将是响应中的 filename、fileType 等。