如何使用json

时间:2018-08-27 07:03:04

标签: json swagger swagger-2.0

因为现在是休假时间,所以我必须完成队友的任务。他用招摇来形容API I程序。

我们现在在API中有一个更加复杂的方法,我在描述以下json时遇到了麻烦:

{
  "sql": [
    {
      "sql": 1,
      "id": "12345"
    },
    {
      "mysql": 0.75,
      "id": "222222"
    },
    {
      "nosql": 0.75,
      "id": "3333333"
    }
  ],
  "pithon": [
    {
      "python": 0.8333333333333334,
      "id": "4444444"
    }
  ]
}

在我们的文档中。根据我告诉他要执行的程序行,我们正在使用swagger 2.3:java -jar swagger-codegen-cli-2.3.1.jar generate -i swagger.json -l html

这是到目前为止我们正在做的一个例子:

[...],
    "id" : {
      "type" : "object",
      "properties" : {
        "id" : {
          "type" : "string",
          "description" : "identification"
        },
        "name" : {
          "type" : "string",
          "description" : "name"
        }
      },
      "example" : {
        "id_value" : "5",
        "name_value": "value 1"
      }
    },
 [...]

由于我以following this为例,所以我想知道如何在swagger文档中使这个更复杂的json响应起作用,并且阅读该文档并没有使它变得更加清晰(部分原因是因为几乎所有我find在YAML中,而不是json)。

到目前为止,这是我得到的,但是我遇到各种各样的错误

"skills" : {
    "type" : "array",
    "properties" : {
        "skill_input" : {
            "type" : "object",
            "properties" : {
                "skill_possible_name" : {
                    "type" : "array",
                    "properties" : {
                        "type" : "string",
                        "description" : "description 11"
                        }
                    }
                }
            }
        }
    }

编辑:我设法获得了部分结果,但是由于某种原因,我得到了重复的示例,所以还不太正确。

"skills": {
      "type": "object",
      "properties": {
        "pithon": {
          "type": "array",
           "items": {
                 "properties" : {
                    "id" : {
                    "type" : "number",
                     "description" : "name of the object"
            },
                    "pithon" : {
                     "type" : "string",
                     "description" : "name of the object"
            }
           }
          }
        },
        "sql": {
          "type": "array",
           "items": {
                 "properties" : {
                    "id" : {
                    "type" : "number",
                     "description" : "name of the object"
            },
                    "mysql" : {
                     "type" : "string",
                     "description" : "name of the object"
            }
           }
          }
        }
      }
    }

0 个答案:

没有答案