rest - 子を持つエンティティの API バージョン管理

Question

一部の API エンドポイントをより簡潔な方法に移行しています。しかし、ネストされたオブジェクトの処理方法についていくつか問題があります。

例えば：

オブジェクトFooとBar.

Foo v1.0

{
  "field_one": "String",
  "field_two": "String"
}

Foo v1.1

{
  "field_one": "String",
  "field_two": "String",
  "field_three": "String"
}

Bar v1.0

{
  "foo": "Foo",
  "field_one": "String",
  "field_two": "String"
}

エンドポイントがFooバージョンを取得するのは非常に簡単v1.0です。子へのすべての変更は、親の新しいバージョンを「生成」する必要がありますか? 親にバージョン管理された子が複数ある場合の処理​​方法は? 2 つの異なるバージョンを持つ別の子がある場合、 のバージョン管理は子の反復に合わせて続行されますか?v1.1BarBarBazBar

Bar v1.0 -> Foo v1.0
Bar v1.1 -> Foo v1.1
Bar v2.0 -> Foo v1.1 + Baz v1.0

Foo v1.1消費者が自分のアプリケーション全体でを使用したい場合に、どのバージョンの を入手すればよいかがわかるように、どうすれば簡単Barにできるでしょうか? ドキュメントだけですか、それともその背後に何らかのパターンがありますか?