4

ドキュメントには Swagger 2.0 を使用しています。私たちは、データ設計ドキュメントからプログラムで swagger 2.0 仕様を作成しています。

私たちのモデルは非常に複雑でネストされています。インラインで定義されたネストされた配列オブジェクトを定義できることを理解したいと思います。

例:

{
    "definitions": {
        "user": {
            "type": "object",
            "required": ["name"],
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": ["home",
                                "office"]
                            },
                            "line1": {
                                "type": "string"
                            }
                        },
                        "Person": {
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
} 

モデルでこれに遭遇する多くのケースがあり、#ref を定義することは、現時点では考慮したくないオプションです。これはインラインで処理する必要があります。

次の投稿によると: https://github.com/swagger-api/swagger-editor/issues/603#evententer code here t-391465196 は、インラインで定義されたネストされた配列オブジェクトの処理をサポートしていないようです。

多くの大企業は非常に複雑なデータ モデルを持っているため、この機能を swagger 2.0 仕様でサポートしたいと考えています。

この機能を追加することについて何か考えはありますか。

4

1 に答える 1