命名空间注册表
为了允许 OpenAPI 描述的创建者定义新的扩展而无需担心名称冲突,OAI 维护了一个命名空间注册表。命名空间注册表是一个简单的唯一标识符列表,用作扩展前缀的一部分以确保唯一性。前缀的格式为 x-{namespace}-
,其中 {namespace}
是与命名空间内扩展创建者关联的唯一字符串。命名空间标识符**必须**注册为小写标识符。
贡献
请提交 拉取请求 或 问题 以贡献或讨论注册表值。
值
值 | 前缀 | 描述 | 问题 |
ms | x-ms- | 由 Microsoft 创建和使用的扩展 | |
oai | x-oai- | 保留用于 OAI 定义的使用 | |
oas-draft | x-oas-draft- | OAI 创建的扩展,用于指示对 OAS 规范的建议更改 | |
oas | x-oas- | 保留用于 OAI 定义的使用 | |
sap | x-sap- | 由 SAP 创建和使用的扩展 | |