1. 人员子集
睿人事OpenAPI
  • 睿人事开放接口
    • OAuth2
      • 获取token
    • 花名册
      • 查询待入职员工列表
      • 查询待入职员工详情
      • 添加待入职员工(简单数据版)
      • 添加待入职员工(完整数据通用版)
      • 待入职员工取消入职
      • 获取待入职记录元数据
      • 获取企业员工列表
      • 获取企业员工详情
      • 修改员工基本信息
      • 查询单个工作信息
      • 新增人员入职花名册
      • 新增工作信息
      • 修改指定工作信息
      • 删除指定工作信息
      • 新增离职工作信息
      • 获取花名册元数据
      • 根据证件号码获取empId
      • 员工搜索
      • 批量获取员工详情
      • 批量查询任职信息
      • 根据证件号批量查询 empId
      • 新增转正工作信息
    • 组织
      • 批量获取指定的组织
      • 获取指定的组织
      • 查询下级组织的组织数据
      • 根据部门获取部门关联的职位
      • 根据部门获取编制信息
      • 搜索组织节点
      • 获取组织节点字段定义
      • 单个创建组织
      • 停用指定的组织节点
      • 获取指定组织的历史记录列表(时间轴)
      • 在指定组织上添加新的历史记录
      • 删除指定的组织历史记录
      • 更新指定的组织历史记录
      • 设置组织关联钉钉通讯录部门
      • 取消组织关联钉钉通讯录部门
    • 成本中心
      • 查询下级成本中心数据 (一级一级给)
      • 创建成本中心
      • 获取成本中心详情
      • 更新成本中心
      • 停用成本中心
    • 生态对接
      • 使用userId置换绑定的empId
      • 使用deptId置换绑定的orgId
      • 使用empId置换绑定的userId
      • 使用orgId置换绑定的deptId
      • 同步员工的生态对接信息
    • 合同
      • 合同列表查询
    • 岗职体系
      • 查询职位详情
      • 查询职位
      • 查询序列
      • 查询职级类别
      • 查询职级
      • 查询职等
      • 查询职务
    • 兼岗
      • 查询员工兼岗信息
      • 批量获取员工兼岗记录 ID
      • 批量新增员工兼岗记录
      • 批量修改员工兼岗记录
      • 批量删除员工兼岗记录
      • 批量查询员工兼岗信息
    • 薪酬
      • 发薪活动
        • 发薪活动列表
        • 获取发薪活动详情
        • 发薪活动 - 添加算薪人员
        • 发薪活动 - 移除算薪人员
        • 获取人员范围
        • 解锁/锁定发薪活动
        • 批量创建发薪活动
        • 批量删除发薪活动
      • 薪资项
        • 获取企业薪资项
      • 薪资数据
        • 获取算薪数据
      • 薪资档案
        • 获取企业薪资档案字段
        • 获取员工适用薪资包
        • 获取薪资包详情
      • 核算组
        • 创建核算组
        • 核算组列表
      • 算薪结果
        • 算薪结果
        • 分段算薪结果
        • 提交智能校验
        • 查询智能校验结果
      • 算税
        • 生成算税人员
        • 查询算税人员生成结果
        • 批量报送算税人员
        • 查询批量报送算税人员结果
        • 更新算税人员信息
        • 查询算税人员信息
        • 提交算薪算税
        • 获得算薪算税反馈
        • 获取扣缴义务人列表
        • 获取6万减除费用人员列表
      • 薪资方案列表
    • 社保
      • 获取参保公司
      • 获取参保方案
      • 获取参保方案详情
    • datart
      • 通过仪表盘获取视图id
      • 通过仪表图表id获取数据定义&数据
    • 人员子集
      • 查询人员子集字段信息
        POST
      • 查询人员子集数据
        POST
      • 创建人员子集数据
        POST
      • 修改人员子集数据
        POST
      • 删除人员子集数据
        POST
    • 字段选项
      • 查询花名册选项类型字段中的选项值
      • 增加花名册选项类型字段中的选项
      • 启用/停用花名册选项类型字段中的选项
      • 修改花名册选项类型字段中的选项值
    • 表单平台
      • 查询表单id和名称
      • 查询表单字段信息
      • 数据查询接口
      • 新增数据
      • 更新数据
      • 删除数据
    • 审批
      • 获取审批实例ID列表
      • 获取单个审批实例详情的数据值
      • 查询审批记录(已经审批和当前审批节点)
      • 提交审批评论
      • 获取审批表单详情
      • 发起审批流程实例
    • 黑名单
      • 获取黑名单列表
    • 合同公司
      • 合同公司列表
    • 审批角色
      • 获取审批角色分组列表
      • 创建审批角色分组
      • 更新审批角色分组
      • 删除审批角色分组
      • 获取审批角色列表
      • 获取审批角色详情
      • 创建审批角色
      • 更新审批角色
      • 删除审批角色
      • 添加角色成员
      • 更新角色成员
      • 批量移除角色成员
      • 获取审批管理员列表
    • 其他模块接口
      • 绩效模块开放接口
      • 培训模块开放接口
      • 招聘模块开放接口
  • 需客户开放接口
    • 事件消息通知
      POST
  1. 人员子集

查询人员子集字段信息

生产环境
https://app91651.eapps.dingtalkcloud.com
生产环境
https://app91651.eapps.dingtalkcloud.com
POST
https://app91651.eapps.dingtalkcloud.com
/open/api/v1/personnel/fields
scope:personnel:fields

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数

Body 参数application/json

示例
{
  "corpId": "",
  "sheetId": ""
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://app91651.eapps.dingtalkcloud.com/open/api/v1/personnel/fields' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "corpId": "",
  "sheetId": ""
}'

返回响应

🟢200查询人员子集字段信息
application/json
Bodyapplication/json

示例
{
    "data": [
        {
            "id": "", //mongoId
            "fieldId": "", //自定义主键id
            "fieldName": "", //自定义字段编码
            "groupId": "", //所属分组id
            "templateId": "", //模板id
            "dataSource": "", //数据来源
            "metaType": "", //数据类型
            "selectField": { //选择字段
                "id": "", //mongoId
                "fieldId": "", //自定义主键id
                "fieldName": "", //自定义字段编码
                "groupId": "", //所属分组id
                "templateId": "", //模板id
                "dataSource": "", //数据来源
                "metaType": "", //数据类型
                "selectField": {}, //选择字段
                "version": 0, //版本号
                "maxVersion": false, //最新版本
                "groupName": "", //所属分组名字
                /**
                 * 自定义字段类型:
                 * 枚举类型待完善:文本、数字、日期、选项
                 */
                "fieldType": "",
                /**
                 * 自定义字段类型:
                 * 枚举类型待完善:文本、数字、日期、选项
                 */
                "fieldTypeDesc": "",
                "multiSelect": false, //单选还是多选
                /**
                 * 是否必填:
                 * 0-否、1-必填
                 */
                "required": false,
                /**
                 * 自定义字段状态;
                 * 枚举类型待完善-停用;生效中;0:删除,1:正常,2:停用
                 */
                "status": "",
                "valueEditable": false, //是否可以编辑。0:不可编辑,1:可编辑
                "system": false, //是否系统字段。0:不是系统字段,1:是系统字段
                "history": false, //是否有历史数据
                "order": 0, //父级分组排序
                "multi": false, //是否有多段数据;0-否;1-是
                "stoppable": false, //是否可以停用;0-否;1-是
                "definitionEditable": false, //是否可以编辑;0-否;1-是
                "placeholder": "", //填写说明
                "addressLevel": "", //地址 3、2、1级 省市区 省市 省
                "fieldShowType": "", //前端展示值
                "objectType": "", //对象类型
                "selection": [ //启用中的下拉框选项
                    {
                        "label": "", //选项中文描述
                        "value": "", //选项编码
                        "order": 0, //选项排序
                        "status": "", //选项状态
                        /**
                         * 所绑定其他选项值
                         * 如:离职类型对应不同的离职原因
                         */
                        "markValue": ""
                    }
                ],
                "stopSelection": [ //停用中的下拉框选项
                    {
                        "label": "", //选项中文描述
                        "value": "", //选项编码
                        "order": 0, //选项排序
                        "status": "", //选项状态
                        /**
                         * 所绑定其他选项值
                         * 如:离职类型对应不同的离职原因
                         */
                        "markValue": ""
                    }
                ],
                "permission": "", //字段权限
                "recurse": false, //组织筛选是否包含下级
                "inputFilter": false, //输入框筛选
                "sortStrategy": [ //排序策略字段
                    {
                        "label": "", //选项中文描述
                        "value": "", //选项编码
                        "order": 0, //选项排序
                        "status": "", //选项状态
                        /**
                         * 所绑定其他选项值
                         * 如:离职类型对应不同的离职原因
                         */
                        "markValue": ""
                    }
                ],
                "editType": "", //编辑方式
                "editTypeDesc": "", //编辑方式描述
                "enabledSelection": [ //启用中的下拉框选项(为了接受前端参数)
                    ""
                ],
                "disabledSelection": [ //停用中的下拉框选项(为了接受前端参数)
                    ""
                ],
                "selectEmpField": "", //选择员工字段(表单平台关联显示人事信息 选择的员工字段)
                "fileTypes": [ //可支持的文件类型
                    ""
                ]
            },
            "version": 0, //版本号
            "maxVersion": false, //最新版本
            "groupName": "", //所属分组名字
            /**
             * 自定义字段类型:
             * 枚举类型待完善:文本、数字、日期、选项
             */
            "fieldType": "",
            /**
             * 自定义字段类型:
             * 枚举类型待完善:文本、数字、日期、选项
             */
            "fieldTypeDesc": "",
            "multiSelect": false, //单选还是多选
            /**
             * 是否必填:
             * 0-否、1-必填
             */
            "required": false,
            /**
             * 自定义字段状态;
             * 枚举类型待完善-停用;生效中;0:删除,1:正常,2:停用
             */
            "status": "",
            "valueEditable": false, //是否可以编辑。0:不可编辑,1:可编辑
            "system": false, //是否系统字段。0:不是系统字段,1:是系统字段
            "history": false, //是否有历史数据
            "order": 0, //父级分组排序
            "multi": false, //是否有多段数据;0-否;1-是
            "stoppable": false, //是否可以停用;0-否;1-是
            "definitionEditable": false, //是否可以编辑;0-否;1-是
            "placeholder": "", //填写说明
            "addressLevel": "", //地址 3、2、1级 省市区 省市 省
            "fieldShowType": "", //前端展示值
            "objectType": "", //对象类型
            "selection": [ //启用中的下拉框选项
                {
                    "label": "", //选项中文描述
                    "value": "", //选项编码
                    "order": 0, //选项排序
                    "status": "", //选项状态
                    /**
                     * 所绑定其他选项值
                     * 如:离职类型对应不同的离职原因
                     */
                    "markValue": ""
                }
            ],
            "stopSelection": [ //停用中的下拉框选项
                {
                    "label": "", //选项中文描述
                    "value": "", //选项编码
                    "order": 0, //选项排序
                    "status": "", //选项状态
                    /**
                     * 所绑定其他选项值
                     * 如:离职类型对应不同的离职原因
                     */
                    "markValue": ""
                }
            ],
            "permission": "", //字段权限
            "recurse": false, //组织筛选是否包含下级
            "inputFilter": false, //输入框筛选
            "sortStrategy": [ //排序策略字段
                {
                    "label": "", //选项中文描述
                    "value": "", //选项编码
                    "order": 0, //选项排序
                    "status": "", //选项状态
                    /**
                     * 所绑定其他选项值
                     * 如:离职类型对应不同的离职原因
                     */
                    "markValue": ""
                }
            ],
            "editType": "", //编辑方式
            "editTypeDesc": "", //编辑方式描述
            "enabledSelection": [ //启用中的下拉框选项(为了接受前端参数)
                ""
            ],
            "disabledSelection": [ //停用中的下拉框选项(为了接受前端参数)
                ""
            ],
            "selectEmpField": "", //选择员工字段(表单平台关联显示人事信息 选择的员工字段)
            "fileTypes": [ //可支持的文件类型
                ""
            ]
        }
    ],
    "success": false, //请求是否成功标志位
    "errorCode": "", //响应编码
    "errorMsg": "" //响应具体信息
}
修改于 2026-08-11 08:34:09
上一页
通过仪表图表id获取数据定义&数据
下一页
查询人员子集数据
Built with