资源列表如何排序

在资源列表的 Query Parameters 中我们会提供 sort 参数作为返回列表资源的排序字段，当参数值开头带有 - (中划线)符号时代表返回资源按倒序排序，反之为正序排序。

正序示例

GET /openapi/2021-08/orders?sort=ID

响应结果

{
    "data": [
        {
            "ID": 1000,
            ...
        },
        {
            "ID": 2000,
            ...
        },
        {
            "ID": 3000,
            ...
        }
    ],
    "links": {
        ...
    },
    "meta": {
        ...
    }
}

倒序示例

GET /openapi/2021-08/orders?sort=-ID

响应结果

{
    "data": [
        {
            "ID": 3000,
            ...
        },
        {
            "ID": 2000,
            ...
        },
        {
            "ID": 1000,
            ...
        }
    ],
    "links": {
        ...
    },
    "meta": {
        ...
    }
}