哪種格式更適合 JSON API 設計中的列表、平面數組或嵌套對象？

Question

對於列表 API，例如Users ，我發現有兩種常見的格式。 數組：

// flat array
[
  {
    "login": "octocat",
    "id": 1
    ...
  },
  ...
]

GitHub 、 Heroku和Twitter使用這種格式

VS 對象：

{
  "results": [
    {
      "login": "octocat",
      "id": 1
      ...
    },
    ...
  ]
}

Parse和Slack和instagram使用這種格式。

哪一個更好？ 如何比較這兩種格式？

Answer 1

面向數組的數據具有以下優點：

• 客戶端 JavaScript 對數組的方法多於對象
• 不需要根節點來模擬表格結構的樹結構

和缺點：

• 沒有命名空間，因為索引是數字
• JSON.parse在客戶端 JavaScript 中失敗

面向鍵/值的數據具有以下優點：

• JSON.parse在客戶端 JavaScript 中工作
• 命名空間使重復值更容易消除歧義
• 與數組方法相比， JSON.stringify使簡單的轉換更容易

和缺點：

• 如果客戶端代碼中沒有庫，則很難迭代嵌套層次結構
• 客戶端代碼中的JSON.parse 去除同級重復鍵名

參考

• 想從 Restful Web 服務返回數組？
• 使用 d3 或 ajax 讀取本地文件文本（制表符分隔值）導致 firefox 開發控制台中的語法錯誤
• 使用 SQL 查詢 JSON/XML/CSV | 喬康利