获取文件夹项目API调用的顺序

Question

我正在使用get文件夹项目API调用，从测试中可以看出顺序似乎首先是文件夹，然后是字母顺序。

此呼叫是否保证总是按该顺序返回项目？

Answer 1

Box平台团队成员在这里...我们不认为我们的任何集合端点返回的结果顺序是其公共合同的一部分，并且它们可能会发生变化。至少对于GET /folders/id/items，JSON响应包含order数组，该数组显示响应的排序方式。

{
    "total_count": 6,
    "entries": [
        {
            "type": "folder",
            "id": "192429928",
            "sequence_id": "1",
            "etag": "1",
            "name": "Lebron and Friends"
        },
        {
            "type": "folder",
            "id": "192429929",
            "sequence_id": "1",
            "etag": "1",
            "name": "Stephen Curry Three Pointers"
        },
        {
            "type": "file",
            "id": "818853864",
            "sequence_id": "0",
            "etag": "0",
            "name": "Heat.jpg"
        },
        {
            "type": "file",
            "id": "818853862",
            "sequence_id": "0",
            "etag": "0",
            "name": "Warriors.jpg"
        }
    ],
    "offset": 0,
    "limit": 4,
    "order": [
        {
            "by": "type",
            "direction": "ASC"
        },
        {
            "by": "name",
            "direction": "ASC"
        }
    ]
}

请注意，此回复还可以包含Web链接。

如果您的应用以某种方式依赖于所订购商品的列表，我们建议在客户端上进行排序。

Answer 2

Box API现在支持排序和方向属性。有关更多详细信息

https://developer.box.com/en/reference/get-folders-id-items/#param-sort