Fecify-顾客留言-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/customer/get-contacts-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取所有店铺的顾客留言分页列表。支持按店铺、邮箱和时间范围筛选。

认证

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

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

请求参数

参数 类型 必填 说明
pageNum Number 否 页码，默认 1
pageSize Number 否 每页条数
shop_id Number 否 店铺 ID
email String 否 顾客邮箱，LIKE 模糊搜索
created_at_begin String 否 创建时间起始，格式 YYYY-MM-DD HH:mm:ss
created_at_end String 否 创建时间结束

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-contacts-list?pageNum=1&pageSize=20&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": {
        "contacts": {
            "list": [
                {
                    "id": 166,
                    "shop_id": 15,
                    "name": "Terry zhao",
                    "telephone": "32132",
                    "email": "fecify@126.com",
                    "created_at": "2026-03-26 06:51:39",
                    "updated_at": "2026-05-01 08:47:42",
                    "status": 2,
                    "custom_attrs": [
                        {"attr_name": "文本输入框", "attr_value": "3232"},
                        {"attr_name": "下拉选项", "attr_value": "11"}
                    ]
                }
            ],
            "total": 33,
            "pageSize": 20,
            "totalPage": 2
        },
        "shop_urls": [
            {
                "shop_id": 15,
                "manager_url": "https://diydomain.fecmall.cn/apimanager666",
                "fornt_url": "https://diydomain.fecmall.cn"
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data.shop_urls Array 关联店铺的商家端和前台 URL

留言分页

字段 类型 说明
list Array 留言记录列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数

list 子项

字段 类型 说明
id Number 留言 ID
shop_id Number 店铺 ID
name String 留言人名称
telephone String 电话
email String 邮箱
created_at String 创建时间
updated_at String 更新时间
status Number 状态：1 = 未读，2 = 已读
custom_attrs Array 顾客提交的自定义表单属性列表，内容取决于店铺后台的自定义属性配置，可能为空数组 []

custom_attrs 子项

字段 类型 说明
attr_name String 自定义属性名称
attr_value String / Array 自定义属性值。单选/文本为字符串，多选时为数组（如 ["red", "blue"]）

注意事项

  1. 所有参数均为选填。
  2. custom_attrs 内容取决于店铺后台的自定义属性配置，不同店铺的字段名和数量可能不同。
  3. 完整留言内容（comment 和 client_details）通过 顾客留言-详细 获取。

results matching ""

    No results matching ""