REST在API响应中返回json数组的最佳实践？[已关闭]

Question

想改进这个问题吗 更新问题，通过编辑这篇文章，可以用事实和引用来回答。

API响应应该始终是JSON对象，键和值是json数组吗？因此：

{
    "foo": [
        {
            "scope": "abcd",
            "allowed": [
                "abc"
            ],
            "denied": [
                "123"
            ]
        },
        {
            "scope": "abcd",
            "allowed": [
                "abc"
            ],
            "denied": [
                "123"
            ]
        }
    ]
}

或者 API 响应本身可以只是一个数组？我找不到这方面的最佳实践是什么，如果一个被认为是一个糟糕的方法。

[
  {
    "scope": "abcd",
    "allowed": [
      "abc"
    ],
    "denied": [
      "123"
    ]
  },
  {
    "scope": "abcd",
    "allowed": [
      "abc"
    ],
    "denied": [
      "123"
    ]
  }
]

Answer 1

我认为第一个选项更适合大多数情况，遵循始终返回JSON对象的原则。

这意味着您的所有客户端(web、桌面或移动)都可以期望所有endpoint返回一个JSON对象。这种方法允许您在不破坏任何客户端应用程序或版本控制的情况下扩展对象，例如，您想要为有问题的数组添加元数据。