java - OpenAPI/Swagger 构建具有多个相同键的对象

Question

我有一些来自内部客户端的令人震惊的响应 JSON 可供使用。不幸的是，他们无法即时更改它，因为多个团队正在向他们发送请求，并且已经在处理这种可怕的响应。

我的问题是，有没有办法使用 OpenAPI 构建一个对象结构，该结构将映射下面传入的 JSON，坦率地说，如您所见，愚蠢的名称/值设置:

{
    "data": [{
            "name": "something",
            "value": "123"
        },
        {
            "name": "something2",
            "value": "str"
        },
        {
            "name": "something3",
            "value": "str123"
        },
        {
            "name": "something4",
            "value": "str456"
        },
        {
            "name": "something5",
            "value": "str333"
        },
        {
            "name": "something6",
            "value": "str333rr"
        },
        {
            "name": "something7",
            "value": "str333rr322"
        },
        {
            "name": "something8",
            "value": "str333rr354"
        },
        {
            "name": "something9:",
            "value": "str333rr354543"
        }
    ]
}

Answer 1

我并没有真正看到这个 JSON 的复杂性，我很快在 swagger 编辑器中做了一些事情来匹配结构:

  NameValue:
    type: object
    properties:
      name:
        type: string
      value:
        type: string

  ResultSet:
    type: object
    properties:
      data:
        type: array
        items:
          $ref: '#/definitions/NameValue'

我错过了什么吗？