如何在符合OpenAPI规范的JSON Schema中定义灵活键结构?
符合OpenAPI规范的JSON Schema实现
针对你需要的结构,完全可以通过JSON Schema的additionalProperties关键字实现“任意字符串作为键”的要求,以下是匹配示例结构的Schema:
{ "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "type": "string" } } }
关键部分说明:
- 顶层
"type": "object":声明整个结构是一个JSON对象 - 顶层
additionalProperties:定义顶层对象中所有任意字符串键对应的值结构——必须是一个对象 - 内层
additionalProperties: { "type": "string" }:定义每个中层对象中所有任意字符串键对应的值必须是字符串类型
这个Schema完全满足你“任意数量顶层/中层元素、结构与示例一致”的要求,和你之前用数组模拟的结构不同,它直接映射了示例中的嵌套对象结构,符合OpenAPI对负载文档的JSON Schema要求。
内容的提问来源于stack exchange,提问作者PaulProgrammer
相关产品推荐
相关产品推荐

