如何在招摇中指定交替参数？

Question

是否可以（以及如何）指定依赖于另一个给定参数的值的附加参数？

我有一个电话PUT/accounts/

一个是< code>payment_method_type，它定义了要设置的付款方式。

现在：如果payment_method_type是直接借记的DD，则允许（并且需要）更多参数，例如account_holder和iban。如果是其他参数，例如PP，则需要其他参数。

"parameters": {
  "payment_method_type": {
    "name": "type",
    "description": "Payment method type.",
    "in": "query",
    "required": true,
    "type": "string",
    "enum": [
      "DD", "IV", "PP"
    ]
  },
  "payment_method_data_dd_account_holder": {
    "name": "account_holder",
    "description": "Name of account holder",
    "in": "query",
    "required": false, # but true if payment_method_type == DD
    "type": "string"
  },
  "payment_method_data_dd_iban": {
    "name": "iban",
    "description": "IBAN",
    "in": "query",
    "required": false, # but true if payment_method_type == DD
    "type": "string"
  },
  "payment_method_data_pp_some_info": {
    "name": "some_info",
    "description": "Some info needed for PP",
    "in": "query",
    "required": false, # but true if payment_method_type == PP
    "type": "string"
  },
}
"paths": {
  "/accounts/{account_id}/payment_method": {
    "put": {
      "summary": "Update Payment Method",
      "description": "...",
      "parameters": {
        {
          "$ref": "#/parameters/path_psp_account_id"
        },
        {
          "$ref": "#/parameters/payment_method_type"
        },
        {
          "$ref": "#/parameters/payment_method_data_dd_account_holder"
        },
        {
          "$ref": "#/parameters/payment_method_data_dd_iban"
        },
        {
          "$ref": "#/parameters/payment_method_data_pp_some_info"
        },
      }
    }
  }
}

我想摆脱长参数列表（因为这里遗漏了更多参数），但如上所述对它们进行分组，并记录某些参数仅适用于特殊类型是必需的（并且允许的）。

有什么方法可以描述这个吗？

有没有一种方法可以像一个定义中的所有直接借记参数一样定义参数集并引用它？备注：这些参数位于payment_method_type参数旁边，不在子对象中。

Answer 1

在当前的swager规范中没有条件参数。

是的，参数数组允许$ref指针。