昶戈开放平台
  1. 部门管理
昶戈开放平台
  • 昶戈开放平台
    • 概述
    • 对接步骤
    • 开始开发
      • 获取企业授权
    • 通讯录管理
      • 岗位管理
        • 批量添加岗位
        • 删除岗位
        • 获取岗位列表
        • 增加/修改岗位信息
        • 批量删除岗位成员数据
        • 增加岗位成员数据
      • 成员管理
        • 批量增加修改用户信息
        • 批量删除用户
        • 批量启用用户
        • 批量停用用户
        • 获取用户列表
        • 增加修改用户信息
        • 获取显示企业用户自定义字段列表 *
      • 产品线管理
        • 删除产品线
        • 获取产品线列表
        • 增加修改产品线人员信息
        • 增加修改产品线信息
      • 标签管理
        • 删除标签
        • 获取标签列表
        • 增加修改标签信息
        • 批量删除标签成员数据
        • 获取标签成员数据
        • 增加标签成员数据
      • 部门管理
        • 批量添加/修改部门
          POST
        • 批量添加部门(树形结构添加)
          POST
        • 删除部门
          POST
        • 获取部门列表
          POST
        • 增加修改部门信息
          POST
    • 授权登录
      • 免登录URL
    • 合作商开放接口
      • 企业配置
        • 获取合作商授权 *
        • 删除企业信息 *
        • 获取企业列表 *
        • 增加/修改企业信息 *
    • 消息和事件通知
      • 消息和事件通知
        • 订阅 *
        • 取消订阅 *
      • 消息和事件通知接收消息
        • 接收消息推送
    • 培训数据
      • 课程
        • 获取PC端首页第一个推荐课程
        • 获取移动端首页第一个推荐课程 *
      • 学员培训数据
        • 获取学员培训项目数据
        • 获取学员培训项目数据 V2
      • 实验室课程
        • 获取课程人员基础信息接口
        • 实验数据上传接口
    • 附录
      • 加密及算法
  1. 部门管理

批量添加/修改部门

测试环境
https://api.test.tgtrain.cn
测试环境
https://api.test.tgtrain.cn
POST
/partner/department/batchaddedit
/partner/department 合作商_部门管理
批量添加/修改部门
DepartmentCode不存在则新增,存在则更新部门名称、父级编码、状态
注:部门需按照父子级结构顺序添加,优先添加父级节点,若先添加子级再添加父级,会导致找不到父级节点,默认放到根节点。

请求参数

Query 参数
access_token
string 
企业密钥
必需
Body 参数application/json
departmentList
array [object {4}] 
*多个名称(必填)
必需
DepartmentName
string 
部门名称
必需
DepartmentCode
string 
部门编码
必需
Status
integer 
必需
部门状态:1 正常 8 停用 9 删除(不传默认为1)
ParentCode
string 
父级部门编码
必需
示例
{
    "departmentList": [
        {
            "DepartmentName": "二级部门",
            "DepartmentCode": "DP100101",
            "Status": 1,
            "ParentCode": "DP1001"
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.test.tgtrain.cn/partner/department/batchaddedit?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "departmentList": [
        {
            "DepartmentName": "二级部门",
            "DepartmentCode": "DP100101",
            "Status": 1,
            "ParentCode": "DP1001"
        }
    ]
}'

返回响应

🟢200返回新增部门id
application/json
Body
data
string 
可选
ret
integer 
可选
返回状态 0成功 1失败
示例
{
    "data": "string",
    "ret": 0
}
🔴500返回错误消息
修改于 2025-01-14 03:11:50
上一页
增加标签成员数据
下一页
批量添加部门(树形结构添加)
Built with