使用REST发送列表/表格数据JSON的正确方法是什么？

Question

我正在使用RESTful API。我们的其中一个屏幕显示总表。

下面是两个JSON响应返回数据

首先

[ 
      { 
        "name": "Richard", 
        "bank_balance": 3000, 
        "assets_worth": 4000, 
        "total": 7000 
      }, 
      { 
        "name": "John", 
        "bank_balance": 1000, 
        "assets_worth": 2000, 
        "total": 3000 
      }, 
      { 
        "name": "Total", 
        "bank_balance":4000, 
        "assets_worth": 6000, 
        "total": 10000 
      }  
    ] 

二

{ 
      "rows": [ 
        { 
          "name": "Richard", 
          "bank_balance": 3000, 
          "assets_worth": 4000, 
          "total": 7000 
        }, 
        { 
          "name": "John", 
          "bank_balance": 1000, 
          "assets_worth": 2000, 
          "total": 3000 
        } 
      ], 


      "grand_total": 
      { 
        "name": "Total", 
        "bank_balance":4000, 
        "assets_worth": 6000, 
        "total": 10000 
      }  
    } 

哪一个更正确的考虑REST的标准呢？

Answer 1

REST仅仅是设计网络应用程序的架构风格。它不直接回答你关于数据结构的问题。

个人而言，我会用第一种方法（只是不含总行）为总计走可以从该行的数据而轻易地计算，从而导致类似：

[ 
    { 
    name: "Richard", 
    bank_balance: 3000, 
    assets_worth: 4000, 
    total: 7000 
    }, 
    { 
    name: "John", 
    bank_balance: 1000, 
    assets_worth: 2000, 
    total: 3000 
    } 
] 

我觉得这里最重要的设计原则是你的API不应该对数据表示置之不理。一些使用您的API的应用程序可能会选择以表格格式显示数据，而其他应用程序可能会选择其他一些表示。一个好的API能够迎合不同的应用程序（和用例）。