REST APIで言語別データの返却値について

Question

特定の用途でなく汎用的に使用される想定のAPIの場合、
以下どちらの作りが好ましいでしょうか。
基本的には言語パラメータで1言語分のみ取得する使い方を想定していますが、
指定しなかった場合全ての言語を返却します。

①

[
  {
    "item_id": 1,
    "jp": {
      "name": "りんご",
      "color": "赤",
      "type": "果物"
    },
    "eg": {
      "name": "apple",
      "color": "red",
      "type": "fruit"
    }
  }
]

②

[
  {
    "item_id": 1,
    "name": "りんご",
    "color": "赤",
    "type": "果物",
    "language": "jp"
  },
  {
    "item_id": 1,
    "name": "apple",
    "color": "red",
    "type": "fruit",
    "language": "eg"
  }
]

やはり情報に無駄がなく、大枠として1レコードで返却される①がベターでしょうか。
言語間で共通となる数値（価格など）がある場合にも、
item_idと同じ階層に置けば重複が省けます。

一方で、外側にgroupのような括りが出てきた場合に、②であればフィールドを1つ増やすだけでよいですが
①の場合外側をくくる階層を増やすべきか悩ましいです。今回私のケースではgroupなどの括りが出る可能性は高いです。
実際にはさらにこの外側にcountやerror_codeなどを含める階層が1、2階層ある想定となり
階層が大分深くなってしまう懸念もあります。（レスポンスは極力フラットにしたほうがよいと認識しています）

ご意見ください。

Comments

[otn]

回答ではありませんが、言語を2文字で表す一般的なやり方があるので、それに倣った方が良いでしょう。ja とか en とか。https://ja.wikipedia.org/wiki/ISO_639-1%E3%82%B3%E3%83%BC%E3%83%89%E4%B8%80%E8%A6%A7 を参照してください

[pokemo]

ありがとうございます！とても参考になりました。

Answer 1

本APIをitems/とする場合、groupでの括りは不適切ですね。
言語については①の方針とし、groupはフィールドとして持つ、がベターのように思えてきました。