Fecify-顾客-列表

接口信息

• 接口地址: {your-site-url}/api/skill/customer/get-customer-list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
• 请求方式: GET
• Content-Type: application/json
• 说明: 获取所有店铺的顾客分页列表。支持按邮箱、手机号、国家、客户类型、订单数、订单金额、注册时间等多维度筛选。

认证

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

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-customer-list?customer_type=1&pageNum=1&pageSize=50&email=fecify%40126.com&shop_id=15' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "customers": {
            "list": [
                {
                    "id": 558,
                    "shop_id": 15,
                    "email": "fecify@126.com",
                    "first_name": "terry",
                    "last_name": "water",
                    "status": 1,
                    "created_at": "2026-04-30 16:42:24",
                    "updated_at": "2026-06-09 19:37:22",
                    "phone": "8632132",
                    "country_code": "US",
                    "area_name": "Armed Forces Americas",
                    "order_count": 23,
                    "order_amount": "9194.31",
                    "note": "",
                    "register_type": 1,
                    "customervip_id": 0,
                    "country": {
                        "code": "US",
                        "cn_name": "美国",
                        "name": "United States"
                    }
                }
            ],
            "total": 1,
            "pageSize": 50,
            "totalPage": 1
        },
        "shop_urls": [
            {
                "shop_id": 15,
                "manager_url": "https://www.fecmall.cn/manager",
                "fornt_url": "https://www.fecmall.cn"
            }
        ]
    },
    "message": "success"
}

返回字段说明

顾客分页

list 子项

注意事项

1. 所有搜索参数均为选填，可任意组合筛选。
2. email 中的 @ 在 URL 中需编码为 %40。
3. created_at_begin 为大于（不含边界），created_at_end 为小于等于（含边界）。
4. order_count 和 order_amount 为脚本定时计算，非实时数据。
5. 完整详情（含 accepts_marketing、verified_email 等）通过 顾客-详情 获取。