组织搜索

接口说明

通过关键词搜索组织内用户，支持按姓名、手机号、用户名匹配，最多返回 20 条结果。

请求信息

项目	内容
请求方式	GET
接口地址	/api/organization/search
鉴权	是，需在请求头中携带 Token

请求参数

参数名	类型	必填	说明
keyword	string	是	搜索关键词，最少 1 个字符，匹配姓名、手机号或用户名

请求示例

curl -X GET "/api/organization/search?keyword=张三" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data	array	用户数组，最多 20 条
data[].id	int	用户 ID
data[].name	string	用户姓名
data[].avatar	string	头像相对路径
data[].department	object | null	所属部门信息，未分配部门时为 null
data[].department.id	int	部门 ID
data[].department.name	string	部门名称
data[].position	string	职位
data[].phone	string	手机号
data[].email	string	邮箱

成功响应

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 101,
      "name": "张三",
      "avatar": "/uploads/avatars/101.jpg",
      "department": {
        "id": 2,
        "name": "技术部"
      },
      "position": "高级工程师",
      "phone": "13800138001",
      "email": "zhangsan@example.com"
    },
    {
      "id": 102,
      "name": "张小三",
      "avatar": "/uploads/avatars/102.jpg",
      "department": null,
      "position": "实习生",
      "phone": "13800138002",
      "email": "zhangxs@example.com"
    }
  ]
}

失败响应

{
  "code": 422,
  "message": "keyword 字段不能为空",
  "data": null
}