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 表示未删除

注意事项

  1. is_deleted必传参数:2 获取正常询盘列表,1 获取回收站列表。
  2. customer_id0 表示游客(未登录顾客)提交的询盘。
  3. product_ids 为空数组时,表示该询盘未关联具体商品(通用询盘/整体询价)。
  4. statusnameemailphone 等搜索字段可组合使用进行多条件筛选。
  5. 时间区间参数需成对使用,格式必须为 YYYY-MM-DD HH:mm:ss
  6. remark 为后台客服添加的内部备注,非顾客提交内容。
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-08-06 15:52:15

results matching ""

    No results matching ""