B2B询盘-列表
获取 B2B 店铺询盘(询价)记录列表,支持分页、多条件搜索,以及正常列表 / 回收站列表切换。
接口信息
- 接口地址:
/apimanager666/api/skill/shopb2b/list
- 请求方式:
GET
- 使用流程:调用本接口获取询盘列表 → 通过
is_deleted 区分正常列表 / 回收站 → 结合 status、时间区间等条件筛选。
相关接口
认证
请求头需携带 skill-access-token:
| 请求头 |
必填 |
说明 |
skill-access-token |
是 |
技能访问令牌 |
Content-Type |
是 |
固定为 application/json |
请求参数
所有参数以 GET Query 形式传递。其中 is_deleted 为必传参数,其余为可选。
| 参数 |
类型 |
必填 |
说明 |
pageNum |
int |
否 |
页码,第 x 页 |
pageSize |
int |
否 |
每页条数,默认 20 |
is_deleted |
int |
是 |
软删除筛选(必传):2 获取正常询盘列表,1 获取回收站列表 |
status |
int |
否 |
处理状态:1 未处理,2 已处理 |
name |
string |
否 |
顾客姓名(模糊搜索) |
email |
string |
否 |
顾客邮箱(模糊搜索) |
phone |
string |
否 |
顾客电话(模糊搜索) |
created_at_begin |
string |
否 |
创建时间区间-开始时间,格式:2026-08-12 00:00:00 |
created_at_end |
string |
否 |
创建时间区间-结束时间,格式:2026-08-12 00:00:00 |
updated_at_begin |
string |
否 |
更新时间区间-开始时间,格式:2026-08-12 00:00:00 |
updated_at_end |
string |
否 |
更新时间区间-结束时间,格式:2026-08-12 00:00:00 |
请求示例
cURL
curl --location --request GET 'http://birox.fecmall.cn/apimanager666/api/skill/shopb2b/list?is_deleted=2' \
--header 'skill-access-token: 24d165ae6d71ca48b0365e25a0d23f79d043e0c1d41b5bada52d54e7ef92a073' \
--header 'Content-Type: application/json' \
--data-raw ''
带搜索条件示例
curl --location --request GET 'http://birox.fecmall.cn/apimanager666/api/skill/shopb2b/list?pageNum=1&pageSize=20&is_deleted=2&status=1&created_at_begin=2026-07-01%2000:00:00&created_at_end=2026-07-31%2023:59:59' \
--header 'skill-access-token: 24d165ae6d71ca48b0365e25a0d23f79d043e0c1d41b5bada52d54e7ef92a073' \
--header 'Content-Type: application/json' \
--data-raw ''
返回结果
{
"code": 200,
"data": {
"list": [
{
"id": 216,
"shop_id": 346,
"status": 1,
"customer_id": 592,
"product_ids": [
"6984"
],
"name": "Terry zhao",
"email": "fecify@126.com",
"phone": "8632132",
"message": "5464565",
"remark": "",
"created_at": "2026-07-02 12:25:13",
"updated_at": "2026-07-02 12:25:13",
"is_deleted": 2,
"deleted_at": 0
},
{
"id": 215,
"shop_id": 346,
"status": 1,
"customer_id": 0,
"product_ids": [],
"name": "Terry zhao",
"email": "fecify@126.com",
"phone": "8632132",
"message": "321312",
"remark": "",
"created_at": "2026-07-02 11:27:15",
"updated_at": "2026-07-02 11:27:15",
"is_deleted": 2,
"deleted_at": 0
}
],
"total": 37,
"pageSize": 20,
"totalPage": 2
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
int |
状态码,200 表示成功 |
message |
string |
提示信息 |
data.total |
int |
询盘总条数 |
data.pageSize |
int |
每页条数 |
data.totalPage |
int |
总页数 |
data.list |
array |
询盘记录数组 |
list 数组元素字段
| 字段 |
类型 |
说明 |
id |
int |
询盘记录 ID |
shop_id |
int |
所属店铺 ID |
status |
int |
处理状态:1 未处理,2 已处理 |
customer_id |
int |
顾客账号 ID,0 表示未登录/游客提交 |
product_ids |
array |
询盘中的商品 ID 数组,可能为空数组 |
name |
string |
顾客姓名 |
email |
string |
顾客电子邮箱 |
phone |
string |
顾客电话 |
message |
string |
顾客留言内容 |
remark |
string |
后台客服对该询盘添加的备注信息 |
created_at |
string |
创建时间 |
updated_at |
string |
更新时间 |
is_deleted |
int |
软删除字段:2 正常询盘,1 已进入回收站 |
deleted_at |
int |
软删除时间戳,0 表示未删除 |
注意事项
is_deleted 为必传参数:2 获取正常询盘列表,1 获取回收站列表。
customer_id 为 0 表示游客(未登录顾客)提交的询盘。
product_ids 为空数组时,表示该询盘未关联具体商品(通用询盘/整体询价)。
status、name、email、phone 等搜索字段可组合使用进行多条件筛选。
- 时间区间参数需成对使用,格式必须为
YYYY-MM-DD HH:mm:ss。
remark 为后台客服添加的内部备注,非顾客提交内容。