1. 部门负责人API列表

1.1. 批量设置部门负责人

描述: 设置部门负责人,人员和部门必须已经存在才能设置成功。

URL: /gateway/openimport/open/company/setOrgAdmins?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

[ //单次同步，最多只允许1000条数据
  {
    "department": String, //部门长名称，格式："一级部门\二级部门\三级部门"，如 ： "研发中心\移动平台产品部\开发部"
    "openId": String, //人员ID
    "weights":int, //可选，部门负责人排序权重，权重越小，排序越前.若不填则以人员权重排序
    "commitId": String //唯一标识一条设置数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
  }
]

输出: 参见输出结果,其中data字段格式如下：

[
  { //只有在有失败数据时返回
    "commitId": String, //提交ID
    "errorMsg": String //此处标识失败原因
  }
]

1.2. 根据组织id批量设置部门负责人

描述: 设置部门负责人,人员和部门必须已经存在才能设置成功。

URL: /gateway/openimport/open/company/setOrgAdminsById?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

[ //单次同步，最多只允许1000条数据
  {
     "orgId": String, //部门id
     "openId": String, //人员ID
     "weights":int, //可选，排序权重，权重越小，排序越前.
     "commitId": String //唯一标识一条设置数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
  }
]

输出: 参见输出结果,其中data字段格式如下：

[
  { //只有在有失败数据时返回
     "commitId": String, //提交ID
     "errorMsg": String //此处标识失败原因
  }
]

1.3. 查询所有部门负责人

描述: 查询所有部门负责人,该接口只返回在职的部门负责人。

URL: /gateway/openimport/open/company/queryOrgAdmins?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{ //分页查询部门负责人，每页限制最多返回1000条记录；count>1000时，截断为1000。
  "begin": int, // 分页起始条数，比如：0
  "count": int // 单次查询条数，比如： 1000
}

输出: 参见输出结果,其中data字段格式如下：

[ //success为true时返回
  {
    "openId": String, //人员openId
    "department": String, //所负责的部门长名称
  }
]

1.4. 批量删除部门负责人

描述: 批量删除部门负责人

注意: deleteAll参数会导致所有部门负责人被删除，请谨慎使用。data部分，特殊含义错误码说明：900014： "负责人不存在"

URL: /gateway/openimport/open/company/deleteOrgAdmins?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
  "deleteAll": Boolean, //是否删除所有,默认值为false。该值传true时，表示删除所有部门负责人（此时list可以不传）；该值为false时，表示删除指定部门负责人，list字段必传。
  "list": [ //指定人员删除时，最多允许一次删除1000条记录
    {
      "department":String, //部门长名称，格式："一级部门\二级部门\三级部门"，如 ： "研发中心\移动平台产品部\开发部"
      "openId":String, //人员ID
      "commitId":String //唯一标识一条数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
    }
  ]
}

输出: 参见输出结果,其中data字段格式如下：

[ //success为true时返回
  {
    "errorCode": Integer, //错误码，注意：该字段可能不返回
    "commitId": String, //提交ID
    "error": String //具体错误消息
  }
]

1.5. 根据组织id批量删除部门负责人

描述: 批量删除部门负责人

URL: /gateway/openimport/open/company/deleteOrgAdminsById?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
  "list": [ //指定人员删除时，最多允许一次删除1000条记录
    {
      "orgId":String, //部门id
      "openId":String, //人员ID
      "commitId":String //唯一标识一条数据，建议使用自增序列（返回时，可用来判断一条记录是否成功）
    }
  ]
}

输出: 参见输出结果,其中data字段格式如下：

[ //success为true时返回
  {
    "errorCode": Integer, //错误码，注意：该字段可能不返回
    "commitId": String, //提交ID
    "error": String //具体错误消息
  }
]

1.6. 删除上级组织负责人

描述: 删除上级组织负责人

URL: /gateway/openimport/open/relationship/deleteOrgAdmins?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
  "deleteAll": Boolean, //是否删除所有,默认值为false。该值传true时，表示删除所有部门负责人（此时list可以不传）；该值为false时，表示删除指定部门负责人，list字段必传。
  "list": [{ //指定人员删除时，最多允许一次删除1000条记录
      "orgId":String, //部门长名称，格式："一级部门\二级部门\三级部门"，如 ： "研发中心\移动平台产品部\开发部"
      "openId":String, //人员ID
  }]
}

1.7. FAQ

暂无