OpenApi v3：additionalProperties false 与引用的架构

Question

关于这个主题有一些问题，但我没有找到正确的方法。

我想要的是在一个地方定义所有参数并重复使用它而无需再次编写它。我已经通过使用“allOf”得到了这一点，但这限制了“additionalProperties”的使用。

我的架构有这样的结构：

SchemaBase:
  type: object
  properties:
    foo:
      type: string

SchemaFull:
  allOf:
    - $ref: '#/components/schemas/SchemaBase'
    - type: object
      properties:
        bar:
          type: string

我尝试使用 using definitions，但在 OpenApi 版本 3 中似乎不再使用了。

Here is a solution 但它不是我要找的，因为那是属性，而不是整个架构。

Answer 1

你需要像这样使用components：

openapi: 3.0.1
info:
  title: OAS 3
  version: 1.0.0
tags:
- name: example
paths:
  /exe:
    post:
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              allOf:
                - $ref: '#/components/schemas/SchemaBase'
                - type: object
                  properties:
                    bar:
                      type: string
      responses:
        200:
          description: Foo
          content: {}
components:
  schemas:
    SchemaBase:
      type: object
      properties:
        foo:
          type: string

你可以在这里看到和玩这个：https://editor.swagger.io/

---

JSON 模式映射：

{
  "additionalProperties": false,
  "allOf": [
    { "$ref": "#/definitions/SchemaBase" },
    {
      "type": "object",
      "properties": {
        "foo": {
          "type": "string"
        }
      }
    }
  ],
  "definitions": {
    "SchemaBase": {
      "type": "object",
      "properties": {
        "foo": {
          "type": "string"
        }
      }
    }
  }
}