api - OpenAPI 表示具有嵌套属性的对象

Question

我有一个带有对象参数的 URL；

https://myurl.com?myobj[anyvalue][limitedvalue]=anyothervalue

Whereanyvalue和anyothervalue可以是任何字符串。中的字符串值limitedvalue是有限的并且是预先知道的。

我如何在 OpenAPI 中表示这一点？

例如，我可以表示具有已知属性的基本对象；

https://myurl.com?myobj[limitedvalue]=anyothervalue

作为;

- name: myobj
  in: query
  required: true
  schema:
    type: object
    properties:
      limitedValueOne:
        type: "string"
      limitedValueTwo:
        type: "string"

标签： apiobjectopenapiurl-parameters