使用json數組和json對象的優點和缺點

Question

我的問題很少理論，但很有趣。 我想知道使用web api時哪種方法最好。

我有兩種方法

1. 一個具有List<Customer>作爲參數

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

其次具有CustomerList作爲參數（ CustomerList類的屬性爲public List<Customer> customers {get; set;}）

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

我知道如何爲方法1中，我需要通過JSON陣列和用於方法的兩個I需要包裝JSON數組到JSON對象。

但我的問題是哪種方法最好，爲什麼？

Answer 1

當涉及到API時，我總是儘可能地明確它涉及到的合同。所以，當你期望一個列表，使用JSON數組。對於API的用戶來說，它會更加清晰。

話雖如此，使用JSON對象的好處是，如果您決定稍後接受您的請求的額外屬性，它不會是一個突破性的變化。

最後，這一切都取決於你的用例。這是否會成爲暴露給其他人的端點而不僅僅是你？您是否已經知道您將來想要接受更多的數據以及客戶列表？這些是你需要問自己的一些問題。