顾客-留言详细

Customer Get Contacts Info API 文档

接口信息

  • 接口地址: {your-site-url}/api/skill/customer/get-contacts-info
  • 基础 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)

字段 类型 必填 说明
id int ✅ 必填 留言 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/customer/get-contacts-info?id=166' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "info": {
            "id": 166,
            "shop_id": 15,
            "status": 2,
            "name": "3232",
            "telephone": "32323",
            "email": "fecify@126.com",
            "comment": "323232",
            "custom_attrs": [
                {
                    "attr_name": "文本输入框",
                    "attr_value": "3232"
                },
                {
                    "attr_name": "下拉选项",
                    "attr_value": "11"
                }
            ],
            "updated_at": "2026-05-01 08:47:42",
            "created_at": "2026-03-26 06:51:39"
        },
        "client_details": {
            "id": 71,
            "shop_id": 15,
            "contacts_id": 166,
            "country_code": "",
            "region_code": "",
            "region_name": "",
            "city": "",
            "timezone": "",
            "longitude": "",
            "latitude": "",
            "client_type": 1,
            "browser_ip": "119.166.179.91",
            "browser_lang": "en-US",
            "browser_height": "945",
            "browser_width": "1905",
            "user_agent": "Chrome",
            "referring_site": "",
            "fist_loading_url": "https://diydomain.fecmall.cn/",
            "created_at": "2026-03-26 06:51:39",
            "updated_at": "2026-03-26 06:51:39",
            "country_name": {
                "name": "",
                "cn_name": ""
            }
        }
    },
    "message": "success"
}

返回字段说明

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

data 顶层字段

字段 类型 说明
info Object 留言详情
client_details Object 客户端详情(提交留言时的浏览器/设备信息)

info 子字段

字段 类型 说明
id int 留言 ID
shop_id int 店铺 ID
status int 状态。1 = 未处理,2 = 已处理
name string 留言人名称
telephone string 电话
email string 邮箱
comment string 留言内容
custom_attrs Array[Object] 顾客留言表单的自定义属性列表
created_at string 创建时间
updated_at string 更新时间

custom_attrs 子项字段

字段 类型 说明
attr_name string 自定义属性名称
attr_value string 自定义属性值

client_details 子字段

字段 类型 说明
id int 记录 ID
shop_id int 店铺 ID
contacts_id int 关联的留言 ID
country_code string 国家代码
region_code string 地区代码
region_name string 地区名称
city string 城市
timezone string 时区
longitude string 经度
latitude string 纬度
client_type int 客户端类型。1 = PC,2 = 平板,3 = 手机
browser_ip string 浏览器 IP
browser_lang string 浏览器语言
browser_height string 浏览器窗口高度(px)
browser_width string 浏览器窗口宽度(px)
user_agent string User Agent
referring_site string 来源网站
fist_loading_url string 首次落地页 URL
created_at string 创建时间
updated_at string 更新时间
country_name Object 国家名称信息

注意事项

  1. id 为必填参数
  2. 返回字段比列表接口多出 comment(留言内容)和 client_details(客户端详情)
  3. client_details 记录了顾客提交留言时的浏览器、IP、语言、屏幕尺寸等信息
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-05-25 14:20:24

results matching ""

    No results matching ""