这是给定 OpenAPI 模式的正确实例示例吗？答案

【问题标题】：Is this the correct instance example for the given OpenAPI schema?这是给定 OpenAPI 模式的正确实例示例吗？
【发布时间】：2021-02-19 03:13:00
【问题描述】：

在编写 OpenAPI 架构组件示例时寻求帮助。架构如下所示：

components:
  schemas:
    ResponseBody:
      type: object
      properties:
        order:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/items'
    items:
      type: object
      properties:
        itemsNo:
          type: string
        item:
          type: array
          items:
            $ref: '#/components/schemas/item'
    item:
      type: object
      properties:
        itemNo:
          type: string
        itemName:
          type: array
          items:
            type: string
        itemDesc:
          type: array
          items:
            type: string
        itemAmount:
          type: array
          items:
            type: string

对于上述架构，我想出的例子是这样的：

{
  "order": "1234",
  "items": [
    {
      "itemsNo": "123",
      "item": [
        {
          "itemNo": "1",
          "itemName": [ "abc","bcs"],
          "itemDesc": [ "desc1", "desc2" ],
          "itemAmount": ["67","12"]
        }
      ]
    },
    {
      "itemsNo": "456",
      "item": [
        {
          "itemNo": "1",
          "itemName": [ "tre","jy"],
          "itemDesc": [ "desc3" ],
          "itemAmount": ["89","23"]
        },
        {
          "itemNo": "1",
          "itemName": [],
          "itemDesc": ["desc4"],
          "itemAmount": []
        }
      ]
    }
  ]
}

你能验证一下它是否正确吗？如果不是，您能否建议一些更改？

【问题讨论】：

标签： openapi

【解决方案1】：

是的，这个 JSON 示例与您的 ResponseBody 架构匹配。

【讨论】：