更新日期:     浏览次数:

1. 上下级关系API列表

接口名称 URL 备注
批量指定上级 /gateway/openimport/open/company/addRelations
批量删除上级 /gateway/openimport/open/company/deleteRelations
删除所有上级 /gateway/openimport/open/relationship/deleteAllRelation
批量查询上级 /gateway/openimport/open/company/queryRelations

1.1. 批量指定上级

描述: 批量指定上级

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

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

[
  {
    "commitId": String, //唯一标识一次提交
    "openId": String, // 人员ID
    "leaderOpenId": String, // 上级ID
    "relationType": String // 指定上级:”LEADER”,汇报上级:”REPORT”(部门负责人默认为汇报上级)
  }
]

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

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

1.2. 批量删除上级

描述: 批量删除上级关系

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

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

[
  {
    "openId": String, // 人员ID
    "leaderOpenId": String, // 上级ID
    "relationType": String // 指定上级:”LEADER”,汇报:”REPORT”
  }
]

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

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

1.3. 删除所有上级

描述: 删除所有上级

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

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

{
  "deleteAll": Boolean, //是否删除所有,默认值为false。该值传true时,表示删除所有部门负责人(此时list可以不传);该值为false时,表示删除指定部门负责人,list字段必传。
  "list": [ //指定人员删除时,最多允许一次删除1000条记录
      {
      "openId": String, // 人员ID
      "leaderOpenId": String, // 上级ID
      "relationType": String // 指定上级:”LEADER”,汇报:”REPORT”           //唯一标识一条数据,建议使用自增序列(返回时,可用来判断一条记录是否成功)
      }
  ]
}

1.4. 批量查询上级

描述: 批量查询上级关系

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

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

{
  "relationType": String, //指定上级:”LEADER”,汇报:”REPORT”
  "begin": String, // 起始
  "count": String //  条数
}

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

[
  {
    "openId": String, // 人员ID
    "leaderOpenId": String, // 上级ID
    "relationType": String // 指定上级:”LEADER”,汇报:”REPORT”(查出未选中的汇报上级,有些部门负责人不需要汇报关系)
  }
]

1.5. FAQ

暂无

results matching ""

    No results matching ""