查询人员子集数据 - 睿人事OpenAPI

scope：personnel:data

fields节点详细说明（多个条件搜索，是取满足各个条件的交集数据）

1、人员类型的字段搜索（结果数据必须包含搜素条件在内，in查询）

{
    "fieldId": "人员类型的fieldId值",
    "selections": [
        "人员1的empIdOne",
        "人员1的empIdTwo"
    ]
}

2、文本类型的字段搜索（eq查询）

{
    "fieldId": "文本类型字段的fieldId值",
    "value": "单行文本3"
}

3、数字类型的字段搜索（支持表达式的搜索，express支持小于（<）、小于等于（<=）、等于（=）、不等于（≠）、大于（>）、大于等于（>=））

{
    "fieldId": "fld_numberglfh71a6gs",
    "value": 6,
    "express": "<"
}

4、组织类型的字段搜索（结果数据必须包含搜素条件在内，in查询）

{
    "fieldId": "组织类型的fieldId值",
    "selections": [
        "组织1的orgIdOne",
         "组织1的orgIdTwo"
    ]
}

5、单选类型的字段搜索（结果数据必须满足搜素条件中的一个，in查询）

{
    "fieldId": "单选类型的fieldId值",
    "selections": [
        "对应字段定义中的 value值1",
        "对应字段定义中的 value值2"
    ]
}

6、多选类型的字段搜索（结果数据必须包含搜素条件中的所有，in查询）

{
    "fieldId": "多选类型的fieldId值",
    "selections": [
        "对应字段定义中的 value值1",
        "对应字段定义中的 value值2"
    ]
}

7、日期字段支持范围搜索（结果数据满足， from<=结果数据日期<=to）

{
    "fieldId": "日期类型的fieldId值",
    "range": {
        "from": "2024-10-22"（yyyy-MM-dd格式）,
        "to": "2024-11-21"（（yyyy-MM-dd格式））
    }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
  "pageSize": 0,
  "page": 0,
  "fields": [
    {
      "fieldId": "",
      "value": "",
      "express": "",
      "range": {
        "from": "",
        "to": ""
      },
      "selections": [
        ""
      ],
      "fieldType": ""
    }
  ],
  "sortFields": [
    {
      "fieldId": "",
      "sortOrder": ""
    }
  ],
  "status": "",
  "corpId": "",
  "sheetId": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200查询人员子集数据-Example

application/json

Bodyapplication/json

示例

{
    "data": {
        "list": [ //数据
            {
                "key": {}
            }
        ],
        "total": 0, //总条数
        "page": 0, //当前页数
        "pageSize": 0, //每页大小
        "notDataPermission": false //没有数据权限，需要单独返回给前端
    },
    "success": false, //请求是否成功标志位
    "errorCode": "", //响应编码
    "errorMsg": "" //响应具体信息
}