me.chanjar.weixin.cp.api.WxCpDepartmentService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of weixin-java-cp Show documentation

微信企业号/企业微信 Java SDK

There is a newer version: 4.6.7.B

package me.chanjar.weixin.cp.api;

import me.chanjar.weixin.common.exception.WxErrorException;
import me.chanjar.weixin.cp.bean.WxCpDepart;

import java.util.List;

/**
 *  *  部门管理接口
 *  Created by BinaryWang on 2017/6/24.
 * 
 *
 * @author Binary Wang
 */
public interface WxCpDepartmentService {

  /**
   *    * 部门管理接口 - 创建部门
   * 最多支持创建500个部门
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=部门管理接口
   * 
   *
   * @param depart 部门
   * @return 部门id
   */
  Integer create(WxCpDepart depart) throws WxErrorException;

  /**
   *    * 部门管理接口 - 查询所有部门
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=部门管理接口
   * 
   */
  List listAll() throws WxErrorException;

  /**
   *    * 部门管理接口 - 修改部门名
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=部门管理接口
   * 如果id为0(未部门),1(黑名单),2(星标组)，或者不存在的id，微信会返回系统繁忙的错误
   * 
   *
   * @param group 要更新的group，group的id,name必须设置
   */
  void update(WxCpDepart group) throws WxErrorException;

  /**
   *    * 部门管理接口 - 删除部门
   * 
   *
   * @param departId 部门id
   */
  void delete(Integer departId) throws WxErrorException;
}