顾客-列表

Customer Get Customer List API 文档

接口信息

• 接口地址: {your-site-url}/api/skill/customer/get-customer-list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取店铺的客户列表，支持多条件筛选和分页

认证

请求头中需要携带以下认证信息：

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-customer-list' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

按邮箱搜索

curl --location --request GET '{your-site-url}/api/skill/customer/get-customer-list?email=fecify@126.com' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

按国家筛选

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

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 571,
                "shop_id": 15,
                "email": "3332232323@qq.com",
                "first_name": "firstname",
                "last_name": "lastname",
                "status": 1,
                "created_at": "2026-05-15 16:00:55",
                "updated_at": "2026-05-15 16:03:04",
                "phone": "",
                "country_code": "US",
                "area_name": "Washington",
                "order_count": 0,
                "order_amount": "0.00",
                "note": "",
                "register_type": 1,
                "customervip_id": 0,
                "payafteruse_status": null,
                "payafteruse_level": null,
                "country": {
                    "code": "US",
                    "cn_name": "美国",
                    "name": "United States"
                }
            }
        ],
        "total": 485,
        "pageSize": 20,
        "totalPage": 25
    },
    "message": "success"
}

返回字段说明

data 顶层字段

list 子项字段

country 子字段

注意事项

1. 此接口为 GET 请求，参数通过 Query String 传递
2. 所有搜索参数均为选填，可任意组合进行筛选
3. email 支持模糊搜索
4. created_at_begin 为大于（不包含边界），created_at_end 为小于等于（包含边界），格式如 2026-05-01 00:00:00
5. order_count_begin/order_count_end 和 order_amount_begin/order_amount_end 同理
6. order_count 和 order_amount 为脚本定时计算所得，非实时数据