OpenApi 3.0 anyOf

Question

 "charge": {
    "properties": {
      "amount": {
        "description": "A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) ",
        "type": "integer"
      },
      "application": {
        "anyOf": [
          {
            "maxLength": 5000,
            "type": "string"
          },
          {
            "$ref": "#/components/schemas/application"
          }
        ],
        "description": "ID of the Connect application that created the charge.",
        "nullable": true,
        "x-expansionResources": {
          "oneOf": [
            {
              "$ref": "#/components/schemas/application"
            }
          ]
        }
      },
      ...

Answer 1

在此示例中，application属性的值可以是：

• 最多5000个字符的字符串（“创建收费的连接应用程序的ID”）
• 应用程序架构
的实例
• null

用Stripe术语来说，application是一个可扩展的属性。可展开属性可以包含关联对象的ID，也可以包含完整对象。这就是它们的X-ExpansionResources扩展所指示的。