简要描述:
- 活码列表
请求域名:
- 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 | 客户数量 |