顾客-订单列表

Customer Get Order List API, 得到顾客的所有订单列表

接口信息

接口地址: {your-site-url}/api/skill/customer/get-order-list
基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
请求方式: GET
说明: 此接口用于获取指定客户的所有订单列表

认证

请求头中需要携带 skill-access-token：

Header	值
`skill-access-token`	`{your-skill-access-token}` （请替换为你自己的 token）

请求参数 (Query String)

字段	类型	必填	说明
`customer_id`	int	✅ 必填	客户 ID
`pageNum`	int	选填	第几页，不填写则默认第 1 页
`pageSize`	int	选填	每页的数据个数，不填写则使用系统默认值

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-order-list?pageNum=1&pageSize=20&customer_id=558' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 6385,
                "shop_id": 15,
                "order_number": "E522522103542077",
                "items_count": 1,
                "created_at": "2026-05-22 20:16:50",
                "updated_at": "2026-05-22 20:16:52",
                "payment_method": "",
                "payment_status": 1,
                "currency_code": "USD",
                "curr_grand_total": "103.70",
                "payed_at": 0,
                "fulfillment_status": 1
            }
        ],
        "total": 40,
        "pageSize": 20,
        "totalPage": 2
    },
    "message": "success"
}

返回字段说明

字段	类型	说明
`code`	Number	状态码，`200` 表示成功
`message`	String	执行结果的文字描述
`data`	Object	返回数据

data 顶层字段

字段	类型	说明
`total`	int	订单总数
`pageSize`	int	每页的数据个数
`totalPage`	int	总页数
`list`	Array[Object]	订单列表

list 子项字段

字段	类型	说明
`id`	int	订单 ID
`shop_id`	int	店铺 ID
`order_number`	string	订单编号
`items_count`	int	订单产品总个数
`created_at`	string	订单创建时间
`updated_at`	string	订单更新时间
`payment_method`	string	支付方式代码。空字符串表示未选择
`payment_status`	int	支付状态。`1` = 初始状态，`2` = 待支付，`21` = 等待支付审核，`3` = 已支付，`4` = 已部分退款，`5` = 已全部退款
`currency_code`	string	订单当前货币
`curr_grand_total`	string	订单总额（当前货币）
`payed_at`	string/int	支付时间。`0` 表示未支付
`fulfillment_status`	int	发货状态（履行）。`1` = 初始状态，`2` = 未发货，`3` = 挂起，`4` = 部分发货，`5` = 全部发货，`6` = 部分收货，`7` = 全部收货，`8` = 全部退货

注意事项

customer_id 为必填参数
此接口返回的订单为摘要信息，不包含 items 明细和 shippingAddress 等详情
如需获取订单详情，请使用订单相关接口

results matching ""

No results matching ""