swagger - 如何在定义中引用 self？

Question

---
swagger: '2.0'
info:
  version: 0.0.0
  title: Simple API
paths:
  /:
    get:
      responses:
        200:
          description: OK
definitions:
  Thing:
    properties:
      parent_thing:
        allOf:
          - $ref: '#/definitions/Thing'
        description: parent of this thing

这是一个最小的例子。如果我在 swagger-editor 中编写此代码，它会显示 Parent_thing 的类型为 undefined: /image/Hqta3.png

我该如何解决这个问题？我希望 Thing 能够引用其他 Thing。

Answer 1

您可以有自引用，但您可能不使用 allOf 构造:

definitions:
  Thing:
    properties:
      parent_thing:
        $ref: '#/definitions/Thing'

以上内容是有效的，如果 swagger-editor 没有正确显示它，那就是一个错误。