顾客-留言详细
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 ''
返回结果
code 为 200 表示调用成功;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 |
国家名称信息 |
注意事项
id 为必填参数
- 返回字段比列表接口多出
comment(留言内容)和 client_details(客户端详情)
client_details 记录了顾客提交留言时的浏览器、IP、语言、屏幕尺寸等信息