Skip to content

查询条件用法

请求参数

名称类型必填描述
filtermulti_filter_condition查询条件
  └ conditionsfilter_condition\[\]比较表达式列表,内容如 base_info.mobile eq "\"+8613000000001\""的比较条件,多个表达式之间的关系为且。
数据校验规则
- 长度范围:010
    └ fieldstring筛选条件的左值,值为字段的参数名称。可选的筛选条件见下文 支持查询的条件 章节。
示例值:"base_info.mobile"
    └ operatorstring比较操作符。可选值有: - eq:等于,支持任何类型的左值 - in:属于任一
示例值:"eq"
    └ valuestring筛选条件的右值,为转义后的json字符串。 - eq匹配字符串,使用 "\"str\"" - in匹配字符串列表,使用 "[\"str\"]" - eq匹配数字列表,使用 "123" - in匹配数字列表,使用 "[123]"
示例值:"\"8619922333322\""

请求示例

json
 {
    "filter": {
        "conditions": [
            {
                "field": "work_info.mobile",
                "operator": "eq",
                "value": "\"+8613000000001\""
            },
          	{
                "field": "work_info.staff_status",
                "operator": "eq",
                "value": "1"
            },
            {
                "field": "base_info.departments.department_id",
                "operator": "in",
                "value": "[\"77a83513ge4c9f91\"]"
            }
        ]
    }
}

支持查询的条件

对象筛选条件的左值(field)左值类型支持的操作符(operator)筛选条件的右值(value)描述
员工base_info.mobilestringeq\"+8613000000001\"按照手机号筛选
员工base_info.mobilestringin[\"+8613000000000\", \"+8613000000002\"]按照手机号筛选
员工base_info.emailstringeq\"111@163.com\"按照邮箱筛选
员工base_info.emailstringin[\"111@163.com\", \"222@163.com\"]按照邮箱筛选
员工work_info.job_numberstringeq\"qwert\"按照工号筛选
员工work_info.job_numberstringin[\"qwert\", \"yuiop\"]按照工号筛选
员工work_info.staff_statusinteq1按照员工人事状态筛选(1-5),需配合部门ID组合查询,在职状态(1)、暂不支持离职状态(2)、待入职状态(3)、取消入职状态(4)、待离职状态(5)筛选
员工base_info.departments.department_idstringeq\"33wqwdsa\"按照部门ID筛选,需配合人事状态组合查询
员工base_info.departments.department_idstringin[\"33wqwdsa\"]按照部门ID筛选,需配合人事状态组合查询
部门parent_department_idstringeq\"33wqwdsa\"按照父部门ID筛选
部门parent_department_idstringin[\"33wqwdsa\",\"33wqwdsb\"]按照父部门ID筛选

右值说明

  • 当左值为int类型且操作符为eq时,值为int字符串,即"1"
  • 当左值为int类型操作符为in时,值为int数组序列化后的值,即"[1,2]"
  • 当左值为string类型且操作符为eq时,值为string序列化后的字符串,即"\"1\""
  • 当左值为string类型操作符为in时,值为string数组序列化后的值,即"[\"1\",\"2\"]"

内容来源:飞书开放平台 · 自动爬取整理