swagger - プロパティを指定する方法は、null または swagger を使用した参照にすることができます

Question

プロパティを null または参照として指定する方法は? jsonschema を使用してプロパティを null または参照として指定する方法について説明します。

私は闊歩で同じことをしようとしています。

上記の答えを要約すると、jsonschema を使用すると、次のことができます。

{
   "definitions": {
      "Foo": {
         # some complex object
      }
   },

   "type": "object",
   "properties": {
      "foo": {
         "oneOf": [
            {"$ref": "#/definitions/Foo"},
            {"type": "null"}
         ]
      }
   }
}

答えのキーポイントは の使用でしoneOfた。

私の質問の要点は次のとおりです。

1. DRY にしたい複雑なオブジェクトがあるので、swagger 仕様全体で再利用するために定義セクションに入れます。他のプロパティの値。応答オブジェクトなど

2. 私の仕様のさまざまな場所で、プロパティはそのようなオブジェクトへの参照である場合もあれば、null である場合もあります。

oneOfまたは をサポートしていない Swagger でこれを指定するにはどうすればよいanyOfですか?

注: 一部の swagger 実装では、x-nullable(またはそのようなものを使用して) プロパティ値を null にできることを指定しますが、オブジェクトをそれが参照するものに$ref 置き換えるx-nullableため、 の使用は無視されるように見えます。

Answer 1