获取花名册元数据

生产环境

https://app91651.eapps.dingtalkcloud.com

POST

/open/api/v1/employee/roster/meta

scope：employee:roster:meta
目前是只返回：基本信息、任职信息、任职状态、离职信息、钉钉通讯录同步这几个分组的数据

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

示例

{
    "corpId": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app91651.eapps.dingtalkcloud.com/open/api/v1/employee/roster/meta' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "corpId": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "data": [
    {
      "groupId": "",
      "groupName": "",
      "fieldMetaInfoList": [
        {
          "fieldId": "",
          "fieldName": "",
          "fieldType": "",
          "multiSelect": false,
          "required": false,
          "selection": [
            {
              "label": "",
              "value": "",
              "order": 0,
              "status": "",
              "markValue": "",
              "orgLabel": ""
            }
          ],
          "stopSelection": [
            {
              "label": "",
              "value": "",
              "order": 0,
              "status": "",
              "markValue": "",
              "orgLabel": ""
            }
          ]
        }
      ],
      "multi": false,
      "multiStrategy": ""
    }
  ],
  "success": false,
  "errorCode": "",
  "errorMsg": ""
}

修改于 2026-07-28 11:20:14

新增离职工作信息

根据证件号码获取empId