数据集成组织架构同步新版SDK
更新于 2024-04-01
接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。
说明
为了确保你在使用接口时能够顺利进行数据交互，请务必检查对应数据模型是否设置枚举值的范围。这一操作需要在组织大脑管理后台的数据集成 > 模型管理的对应数据模型中进行查看，如果未正确设置枚举值范围，调用接口时可能会遇到错误信息。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 组织大脑数据集成写入权限 | API Explorer |
请求方法
Loading...
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证，可通过调用获取用户token接口获取。 |
Query参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
corpId | String | 是 | 组织编码。 |
Body参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
Array | 是 | 数据集。 | |
deptNo | String | 是 | 部门 ID。 |
deptName | String | 是 | 部门名称。 |
superDeptNo | String | 是 | 上级部门 ID。 |
superDeptName | String | 否 | 上级部门名称。 |
superEmpId | String | 否 | 部门主管 UserId。 |
superName | String | 否 | 部门主管名称。 |
createDate | String | 否 | 创建日期。 |
effectiveDate | String | 否 | 生效日期。 |
isEffective | String | 否 | 是否有效。 |
extendInfo | Map | 否 | 扩展字段，KV结构。 |
返回参数
名称 | 类型 | 描述 |
|---|---|---|
result | Boolean | 更新是否成功：
|
success | Boolean | 接口调用是否成功：
|
requestId | String | 请求 ID。 |
示例
请求示例
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
返回示例
Loading...
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | serviceError | service error. %s | 执行异常 |
401 | paramIllegal | param illegal. %s | 入参错误 |
