时间戳

首页 > 解决方案 > 基于 JSON Schema 的文档

json - 基于 JSON Schema 的文档

问题描述

我想使用我的 JSON 模式来生成文档。

在下面的示例中，我想以 JSON 格式列出我的输出消息中可用的所有 ErrorNumber/ErrorMessage 组合。

但是我在对象级别上找不到方法，我对“示例”或“枚举”的尝试失败了。

有没有人有办法解决吗？

{
    "type": "object",
    "required": [
        "ErrorNumber",
        "ErrorMessage"
    ],
    "properties": {
        "ErrorNumber": {
            "$id": "#root/ErrorNumber", 
            "type": "integer"
        },
        "ErrorMessage": {
            "$id": "#root/ErrorMessage", 
            "type": "string"
        }
    }
}

标签： jsondocumentationjsonschema

解决方案

  1. 你的意思是写"$ref"你"$id"在例子中使用的地方吗？

  2. 你到底在哪里遇到问题enum？以下对我来说适用于 draft-2020-12 验证器（并且在删除您的“$id”之后！）：

{
  // ... your JSON here ...
  "enum": [
    {"ErrorNumber": 200, "ErrorMessage": "OK"},
    {"ErrorNumber": 404, "ErrorMessage": "Not found."}
    // ...
  ]
}
  1. 不同的方法，以防您仍然可以更改：

如果您的错误编号从 0 开始并且是连续的，那么消息数组可能会达到您的目的。

或者，带有数字键的对象可能：

{
  "200": "OK",
  "404": "Not found."
}

推荐阅读