订购获取文件夹项API调用

时间:2013-10-23 16:35:09

标签: box-api

我正在使用get文件夹项API调用,我可以从测试中看出订单首先显示为文件夹,然后按字母顺序排列。

此电话会保证始终按该顺序退回商品吗?

1 个答案:

答案 0 :(得分:2)

Box Platform团队成员在这里...我们不会考虑我们的任何集合端点返回的结果的顺序是他们的公共合同的一部分,并且它们可能会发生变化。至少对于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"
        }
    ]
}

请注意,此回复还可以包含网络链接。

如果您的应用依赖于以特定方式订购的商品列表,我们建议您在客户端进行排序。