使用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能夠迎合不同的應用程序（和用例）。