简要描述:

  • 活码列表

请求域名:

  • http://xx.com

请求URL:

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

参数:

参数名 是否必须 类型 说明
search[lock_uid] int 锁客会员ID
search[lock_member_kwd] string 锁客会员昵称姓名手机号
search[department_id] int 部门ID
search[staff_kwd] string 员工姓名手机号
search[source_staff_name] 创建人姓名
search[name] 活码名称
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,
			"staff_id": 51,
			"staff_userid": "XUJIAJIAN2XUJIAJIAN2X_1631087200",
			"poster_id": 82,
			"name": "testcode",
			"state": "staff_code_1",
			"config_id": "82a5a01e0bc42e6721b691247fb708ca",
			"code": "https:\/\/wework.qpic.cn\/wwpic3az\/409675_OIK3EEa4RpKOUbS_1773136253\/0",
			"status": 1,
			"source_staff_id": 46,
			"lock_uid": 163951,
			"created_at": "2026-03-10 17:50:52",
			"updated_at": "2026-03-10 17:50:53",
			"deleted_at": null,
			"customer_count": 0,
			"department_name": "子部门2",
			"has_one_lock_member": {
				"uid": 163951,
				"nickname": "夜色初明时",
				"avatar": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/JA5cVN4azDzYZHvrXicDeDkV3cxiaYf2JqoPPy2dkuJiaR3gxkoOiaoXqEibPFWeMmAcRKpOwUL9sD0OdpNbSia5NsgQ\/132",
				"avatar_image": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/JA5cVN4azDzYZHvrXicDeDkV3cxiaYf2JqoPPy2dkuJiaR3gxkoOiaoXqEibPFWeMmAcRKpOwUL9sD0OdpNbSia5NsgQ\/132",
				"username": "夜色初明时"
			},
			"has_one_staff": {
				"id": 51,
				"uniacid": 25,
				"business_id": 11,
				"uid": 163951,
				"user_id": "XUJIAJIAN2XUJIAJIAN2X_1631087200",
				"name": "许家健233",
				"mobile": "15886404095",
				"position": "php程序员",
				"gender": 1,
				"telephone": "10086",
				"email": "10086@qq.com",
				"avatar": "https:\/\/wework.qpic.cn\/wwpic3az\/80337_mYSmVPN8S0CtkX8_1770779206\/0",
				"alias": "xu",
				"status": 1,
				"qr_code": "https:\/\/open.work.weixin.qq.com\/wwopen\/userQRCode?vcode=vcae7f6ec216ab8772",
				"address": "汇创意产业园",
				"open_userid": "11_XUJIAJIAN2XUJIAJIAN2X_1631087200",
				"main_department": "3",
				"updated_at": "2026-02-11 11:06:49",
				"created_at": "2021-10-18 09:52:09",
				"deleted_at": null,
				"right_type": 1,
				"disabled": 0,
				"userid": "XUJIAJIAN2XUJIAJIAN2X_1631087200",
				"avatar_mediaid": "https:\/\/wework.qpic.cn\/wwpic3az\/80337_mYSmVPN8S0CtkX8_1770779206\/0",
				"has_one_member": {
					"uid": 163951,
					"nickname": "夜色初明时",
					"avatar": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/JA5cVN4azDzYZHvrXicDeDkV3cxiaYf2JqoPPy2dkuJiaR3gxkoOiaoXqEibPFWeMmAcRKpOwUL9sD0OdpNbSia5NsgQ\/132",
					"avatar_image": "https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/JA5cVN4azDzYZHvrXicDeDkV3cxiaYf2JqoPPy2dkuJiaR3gxkoOiaoXqEibPFWeMmAcRKpOwUL9sD0OdpNbSia5NsgQ\/132",
					"username": "夜色初明时"
				}
			},
			"has_one_source_staff": {
				"id": 46,
				"name": "测试员工",
				"userid": null,
				"avatar_mediaid": null
			},
			"has_many_department_staff": [{
				"id": 17,
				"uniacid": 25,
				"business_id": 11,
				"staff_id": 51,
				"department_id": 46,
				"is_leader": 0,
				"sort": 1,
				"updated_at": "2021-11-17 14:12:25",
				"created_at": "2021-11-17 14:12:25",
				"deleted_at": null
			}]
		}],
		"first_page_url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/codeList?page=1",
		"from": 1,
		"last_page": 1,
		"last_page_url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/codeList?page=1",
		"links": [{
				"url": null,
				"label": "« 上一页",
				"active": false
			},
			{
				"url": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/codeList?page=1",
				"label": "1",
				"active": true
			},
			{
				"url": null,
				"label": "下一页 »",
				"active": false
			}
		],
		"next_page_url": null,
		"path": "https:\/\/dev15.yunzmall.com\/business\/25\/plugin\/StaffCode\/codeList",
		"per_page": 15,
		"prev_page_url": null,
		"to": 1,
		"total": 1,
		"department_list": [{
				"id": 45,
				"name": "芸信"
			},
			{
				"id": 46,
				"name": "子部门2"
			},
			{
				"id": 47,
				"name": "x测试部门1"
			},
			{
				"id": 48,
				"name": "测试部门33"
			},
			{
				"id": 67,
				"name": "3D建模部"
			},
			{
				"id": 97,
				"name": "我的测试部门"
			},
			{
				"id": 414,
				"name": "精英部"
			},
			{
				"id": 428,
				"name": "三十三"
			},
			{
				"id": 462,
				"name": "其他(待设置部门)"
			},
			{
				"id": 464,
				"name": "油站"
			},
			{
				"id": 470,
				"name": "2"
			},
			{
				"id": 49,
				"name": "子部门2-22"
			},
			{
				"id": 50,
				"name": "子部门2-3"
			},
			{
				"id": 51,
				"name": "销售部"
			},
			{
				"id": 53,
				"name": "子部门2-1"
			},
			{
				"id": 76,
				"name": "test-部门A"
			},
			{
				"id": 468,
				"name": "ces"
			},
			{
				"id": 54,
				"name": "测试部门335"
			},
			{
				"id": 55,
				"name": "测试部门33"
			},
			{
				"id": 57,
				"name": "子部门1"
			},
			{
				"id": 77,
				"name": "test-部门s"
			},
			{
				"id": 95,
				"name": "为二万人"
			},
			{
				"id": 58,
				"name": "123456"
			},
			{
				"id": 59,
				"name": "测试部门335-1"
			},
			{
				"id": 61,
				"name": "部门233"
			}
		]
	}
}

错误时返回:

  {
  }

返回参数说明:

参数名 类型 说明
名称 类型 说明
department_list arr 部门列表
data.data[id] int ID
data.data[has_one_source_staff].name string 创建人
data.data[name] string 活码名称
data.data[department_name] string 部门名称
data.data[has_one_staff].name string 员工姓名
data.data[has_one_staff].has_one_member object 员工会员
data.data[has_one_lock_member] object 锁客会员
data.data[customer_count] int 客户数量