OpenAPI 规范 v3.1.0
OpenAPI 规范 v3.1.0
1. OpenAPI 规范
2. 简介
3. 定义
4. 规范
4.1 版本
4.2 格式
4.3 文档结构
4.4 数据类型
4.5 富文本格式化
4.6 URI 中的相对引用
4.7 URL 中的相对引用
4.8 模式
4.8.1 OpenAPI 对象
4.8.2 Info 对象
4.8.3 Contact 对象
4.8.4 License 对象
4.8.5 Server 对象
4.8.6 Server Variable 对象
4.8.7 Components 对象
4.8.8 Paths 对象
4.8.9 Path Item 对象
4.8.10 Operation 对象
4.8.11 External Documentation 对象
4.8.12 Parameter 对象
4.8.13 Request Body 对象
4.8.14 Media Type 对象
4.8.15 Encoding 对象
4.8.16 Responses 对象
4.8.17 Response 对象
4.8.18 Callback 对象
4.8.19 Example 对象
4.8.20 Link 对象
4.8.21 Header 对象
4.8.22 Tag 对象
4.8.23 Reference 对象
4.8.24 Schema 对象
4.8.25 Discriminator 对象
4.8.26 XML 对象
4.8.27 Security Scheme 对象
4.8.28 OAuth Flows 对象
4.8.29 OAuth Flow 对象
4.8.30 Security Requirement 对象
4.9 规范扩展
4.10 安全过滤
4.8.6 Server Variable 对象
创建时间: 2025-05-29 16:38
4.8.6.1 固定字段
字段名称 | 类型 | 描述 |
---|---|---|
枚举 | [string ] | 如果替换选项来自有限的集合,则要使用的字符串值的枚举。数组不得为空。 |
默认值 | 字符串 | 必需。要用于替换的默认值,如果未提供备用值,则应发送此值。请注意,此行为与Schema 对象处理默认值的方式不同,因为在这些情况下,参数值是可选的。如果定义了enum ,则该值必须存在于枚举的值中。 |
描述 | 字符串 | 服务器变量的可选描述。[CommonMark 规范] 语法可以用于富文本表示。 |
此对象可以使用 规范扩展 进行扩展。***
最后更新: -