格式化 API 的 JSON 数组

Question

我正在设计一些需要获取/发布（获取/添加）对象数组的 REST 样式 API 端点。

是否有充分的理由采用以下格式：

{"Objects" : [{"Field1:Val1","Field2:Val2"},{"Field1:Val1","Field2:Val2"}]}

而不是省略顶级"对象"而只使用以下对象？

[{"Field1:Val1","Field2:Val2"},{"Field1:Val1","Field2:Val2"}]

Answer 1

重要的是，你的数据必须是结构化的。

使用{"Objects" : [{"Field1:Val1","Field2:Val2"},{"Field1:Val1","Field2:Val2"}]}您将能够添加具有不同结构的其他类型的对象{"Field1:Val1","Field2:Val2"}

例如：{"firstname":"Tata", "lastname":"Toto","objects" : [{"name":"hammer","nb":4},{"name":"screw","nb":5}]}

所以这里的结构是：

firstname : string 
lastname : string 
objects : 
    name : string
    nb : int

如果您使用 [{"Field1:Val1","Field2:Val2"},{"Field1:Val1","Field2:Val2"}] ，我们希望在您的数组中，元素表示相同类型的数据。