首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >问答首页 >这个OpenAPI/Swagger规范是什么意思?

这个OpenAPI/Swagger规范是什么意思?
EN

Stack Overflow用户
提问于 2022-07-07 17:55:00
回答 2查看 155关注 0票数 3

有问题的规范:

代码语言:javascript
运行
复制
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来响应fileid请求。服务器存储视频。

来自服务器的响应,应该是用户可以在browser/Postman中播放的视频,还是应该是视频的字节数组?

即应作出以下答复:

另外,content#video/mp4 / content#video/mpeg是什么意思?我是否需要在我的响应中将content-type设置为这2项中的一项?

我的Content-Disposition应该是什么?

EN

回答 2

Stack Overflow用户

发布于 2022-07-15 04:39:38

答案是第一个例子中的视频,或者更准确地说,是一个字节流,它对应于请求的内容类型video/mp4video/mpeg,其中包含一个Content-Disposition头。

如果响应是JSON块,如第二个示例所示,响应内容类型将是application/json (或等效的),并且它将显式列出响应对象模式,即响应中将有一个filenamefileType等。

票数 1
EN

Stack Overflow用户

发布于 2022-07-15 07:29:25

OpenAPI规范说:

  1. 发布端点/文件/ {fileid},其中{fileid}是路径参数。
  2. 在答复中,你提供:
  • 消息体中视频的二进制数据
  • 内容-类型为,其中之一为:
    • 视频/MP4
    • 视频/mpeg

  • 内容-配置标头的值之一:
    • 内容处理:内联(如果视频应在浏览器内播放)
    • 内容处理:附件;filename="filename.mp4“(如果要下载视频)

关于内容配置头,请参见获得更多的文档

票数 0
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/72902293

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档