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

Question

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

此调用是否保证始终按该顺序返回项目？

Answer 1

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

{
    "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 链接。

如果您的应用程序依赖于以某种方式排序的项目列表，我们建议在客户端进行排序。