使用json数组和json对象的优点和缺点

Question

我的问题不是理论上的问题，而是一个有趣的问题。 我想知道在使用web api时哪种方法最好。

我有两种方法

1. 其中一个List<Customer>作为参数

  

public void Create(List<Customer>) { //... }

1. 其次以CustomerList为参数（Where CustomerList类具有属性public List<Customer> customers {get; set;}）

  

public void Create(CustomerList customer) { //... }

我知道方法1的方法，我需要传递json数组，对于方法2，我需要将json数组包装到json对象。

但我的问题是哪种方法最好，为什么？

Answer 1

当谈到API时，我总是试图尽可能地明确它所公开的合同。因此，当您期望List时，请使用JSON数组。 API的用户将更加清楚预期的内容。

话虽如此，使用JSON对象的好处是，如果您决定稍后在您的请求中接受额外的属性，它将不会是一个重大变化。

最后，这一切都取决于您的用例。这是否会成为一个暴露给其他人的终点而不仅仅是你？您是否已经知道您将来希望接受其他数据以及客户列表？这些是您需要问自己的一些问题。