本文介绍了如何使用OpenAPI(Swagger)描述多部分响应?的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!
问题描述
我有一项服务可创建包含以下内容的多部分文件:
I have a service that creates a multipart file containing:
- 代表图像缓冲区的数据字节数组
- 表示图像信息(坐标,格式等)的JSON
是否可以使用YAML在OpenAPI(Swagger)定义中对此自定义响应建模?
Is it possible to model this custom response in an OpenAPI (Swagger) definition, using YAML?
推荐答案
可以使用OpenAPI 3.0而不是OpenAPI 2.0(fka Swagger 2.0)描述多部分响应.
Multipart responses can be described using OpenAPI 3.0, but not OpenAPI 2.0 (fka Swagger 2.0).
openapi: 3.0.0
...
paths:
/something:
get:
responses:
'200':
description: OK
content:
multipart/mixed: # <-- Content-Type of the response
schema:
type: object
properties:
# Part 1 - application/octet-stream
file: # <-- part name
type: string
format: binary
# Part 2 - application/json
metadata: # <-- part name
type: object
properties:
foo:
type: string
example: bar
required:
- foo
# Optional, see https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#encoding-object
encoding:
file:
...
metadata:
...
可选的 encoding
键可用于覆盖子零件的Content-Type
或添加子零件的标题(例如Content-Disposition
).
The optional encoding
key can be used to override the Content-Type
for subparts or add headers for subparts (e.g. Content-Disposition
).
这篇关于如何使用OpenAPI(Swagger)描述多部分响应?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持!