简要描述：

  • 客户列表

请求域名:

  • http://xx.com

请求URL:

xx.com/business/{公众号id}/plugin/StaffCode/customerList

参数:

参数名 是否必须 类型 说明
search[code_id] 是 int 活码ID
search[customer_uid] 否 int 客户会员ID
search[customer_member_kwd] 否 string 客户会员昵称姓名手机号
search[time_search] 否 string 搜索时间字段，如搜索时间固定传created_at，否则不传
search[time_arr] 否 arr 起始结束时间戳数组

返回示例:

正确时返回:

{
	"result": 1,
	"msg": "成功",
	"data": {
		"current_page": 1,
		"data": [{
			"id": 1,
			"uniacid": 25,
			"business_id": 11,
			"code_id": 1,
			"staff_id": 48,
			"staff_userid": "PeiCan",
			"customer_userid": "wmDesSDgAAe9AIN_1HXUP6NzoryakDlQ",
			"follow_userid": 148,
			"created_at": "2026-03-11 13:54:55",
			"updated_at": "2026-03-11 13:54:55",
			"deleted_at": null,
			"tag_list": [{
					"tag_id": "etDesSDgAAfE4p9C2zZNml4icB1pVBOQ",
					"name": "333"
				},
				{
					"tag_id": "etDesSDgAAlS6vz3D0zoYySK5E2u2VDQ",
					"name": "测试排序标签"
				}
			],
			"has_one_staff": {
				"id": 48,
				"uniacid": 25,
				"business_id": 11,
				"uid": 163952,
				"user_id": "PeiCan",
				"name": "肖培灿",
				"mobile": "15603091690",
				"position": "",
				"gender": 1,
				"telephone": "",
				"email": "",
				"avatar": "https:\/\/wework.qpic.cn\/bizmail\/R6sHN3BlFt9yAH6Ltfq3WH32TvuEwLI82hAtIAw76iaLgQpzgGIEp5Q\/0",
				"alias": "",
				"status": 1,
				"qr_code": "https:\/\/open.work.weixin.qq.com\/wwopen\/userQRCode?vcode=vce245ad16786dea72",
				"address": "",
				"open_userid": "11_PeiCan",
				"main_department": "1",
				"updated_at": "2024-03-25 13:47:52",
				"created_at": "2021-10-18 09:52:09",
				"deleted_at": null,
				"right_type": 1,
				"disabled": 0,
				"userid": "PeiCan",
				"avatar_mediaid": "https:\/\/wework.qpic.cn\/bizmail\/R6sHN3BlFt9yAH6Ltfq3WH32TvuEwLI82hAtIAw76iaLgQpzgGIEp5Q\/0"
			},
			"has_one_follow_user": {
				"id": 148,
				"uniacid": 25,
				"crop_id": 11,
				"uid": 164894,
				"userid": "PeiCan",
				"external_userid": "wmDesSDgAAe9AIN_1HXUP6NzoryakDlQ",
				"remark": "Happy",
				"description": "",
				"customer_create_time": "2026-03-04 15:33:47",
				"remark_corp_name": "",
				"remark_mobiles": "[]",
				"oper_userid": "PeiCan",
				"tag_id": "etDesSDgAAlS6vz3D0zoYySK5E2u2VDQ,etDesSDgAAfE4p9C2zZNml4icB1pVBOQ",
				"createtime": 1772609627,
				"add_way": "1",
				"state": "",
				"status": 1,
				"created_at": "2026-03-04 15:33:49",
				"updated_at": "2026-03-04 15:33:49",
				"deleted_at": null,
				"loss_time": null,
				"tag_name": "333,测试排序标签",
				"has_one_member": {
					"uid": 164894,
					"nickname": "Happy",
					"avatar": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/f5226ebNpIvaazfXUI0rI26j7bEDZricdKd3PsnickLDrrG99OQsVOexY537PT7ssicFtqticlUCC9heoHg0WUhdDg\/132",
					"avatar_image": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/f5226ebNpIvaazfXUI0rI26j7bEDZricdKd3PsnickLDrrG99OQsVOexY537PT7ssicFtqticlUCC9heoHg0WUhdDg\/132",
					"username": "Happy"
				}
			}
		}],
		"first_page_url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/customerList?page=1",
		"from": 1,
		"last_page": 1,
		"last_page_url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/customerList?page=1",
		"links": [{
				"url": null,
				"label": "« 上一页",
				"active": false
			},
			{
				"url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/customerList?page=1",
				"label": "1",
				"active": true
			},
			{
				"url": null,
				"label": "下一页 »",
				"active": false
			}
		],
		"next_page_url": null,
		"path": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/customerList",
		"per_page": 15,
		"prev_page_url": null,
		"to": 1,
		"total": 1
	}
}

错误时返回:

  {
  }

返回参数说明:

参数名 类型 说明
名称 类型 说明
data.data[has_one_follow_user].uid int 客户ID
data.data[has_one_follow_user].has_one_member object 客户关联会员信息
data.data[created_at] string 添加时间
data.data[tag_list] arr 标签列表