模式的额外信息 - 例子

一个常见的用例是添加一个将在文档中显示的example。

有几种方法可以声明额外的 JSON 模式信息。

您可以使用 Config 和 schema_extra 为Pydantic模型声明一个示例，如中所述:

这些额外的信息将按原样添加到输出的JSON模式中。

Field 的附加参数

Warning

请记住，传递的那些额外参数不会添加任何验证，只会添加注释，用于文档的目的。

你可以通过传递额外信息给 Field 同样的方式操作Path, Query, Body等。

比如，你可以将请求体的一个 传递给 Body:

文档 UI 中的例子

关于 example 和 examples…

JSON Schema在最新的一个版本中定义了一个字段 examples ，但是 OpenAPI 基于之前的一个旧版JSON Schema，并没有 examples.

所以 OpenAPI为了相似的目的定义了自己的 (使用 example, 而不是 examples), 这也是文档 UI 所使用的 (使用 Swagger UI).

其他信息

同样的方法，你可以添加你自己的额外信息，这些信息将被添加到每个模型的JSON模式中，例如定制前端用户界面，等等。