Swagger docs-单个http响应的多个错误代码

Question

我试图记录一个总是返回自定义响应代码和相关描述的模型。对于单个HTTP响应代码，可以有多个自定义响应代码。例如，400响应可能包括：

+===========+======+=============+
| HTTP Code | Code | Description |
+===========+======+=============+
|       400 |    1 | Error 1     |
+-----------+------+-------------+
|       400 |    2 | Error 2     |
+-----------+------+-------------+
|       400 |    3 | Error 3     |
+-----------+------+-------------+

我可以记录400状态返回一个“Error”对象，该对象具有“Code”和“Description”。但如果可能的话，我想在文档中包含所有自定义状态代码。有可能吗？如果是这样，我该怎么做？

Answer 1

对于现在面临这个问题的任何人来说，以下是我如何解决它的：

              '422':
                description: 'Unprocessable Entity'
                content:
                    application/json:
                        schema:
                          oneOf:
                            - $ref: '#/components/schemas/SchemaForErrror1'
                            - $ref: '#/components/schemas/SchemaForErrror2'

                        examples:
                          Error1:
                            $ref: '#/components/examples/ExampleForError1'
                          Error2:
                            $ref: '#/components/examples/ExampleForError2'