json - 使用 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 能够很好地满足不同的应用程序（和用例）。