いろいろアプリを作った上で、APIの実装をまとめ

APIの設計で単純な配列返すAPIでも、オブジェクトで返してげた方がよさそう。
Jsonのフォーマットとして、下記でも問題ないんですが、後々困る。

例）/list/brands.json

[
	{
		'keyword': 'ユニクロ',
		'rank': 1
	}
	{
		'keyword': 'しまむら',
		'rank': 2
	}
	{
		'keyword': 'H&M',
		'rank': 3
	}
]

あとで、このAPIをたたく画面で追加要素とかいろいろ出てきます。
画面のタイトルをAPIから返したいとか、画像をつけたいなど・・・
一度APIとアプリをリリースしてしまうと、アプリのアップデートが終わるまでJsonにオブジェクトは足せても、フォーマットは変えられない。

{
	brands: [
		{
			'keyword': 'ユニクロ',
			'rank': 1
		}
		{
			'keyword': 'しまむら',
			'rank': 2
		}
		{
			'keyword': 'H&M',
			'rank': 3
		}
	]
}

あとから、popularやnoticeのオブジェクト追加しても古いアプリでも問題なく動作する。

{
	popular: {
		pic_id : 1,
		thumbnail: 'http://example.com/thumbnail.jpg',
		description: 'なんとかかんとか'
	}
	notice: {
		notice_id: 12,
		title: '運営からのお知らせ'
	}
	brands: [
		{
			'keyword': 'ユニクロ',
			'rank': 1
		}
		{
			'keyword': 'しまむら',
			'rank': 2
		}
		{
			'keyword': 'H&M',
			'rank': 3
		}
	]
}