因为现在是休假时间,所以我必须完成队友的任务。他用招摇来形容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"
}
}
}
}
}
}