Développement C# du portail WeChat et application du développement de la gestion du carnet d'adresses des comptes d'entreprise WeChat et de la gestion des membres

1. Opération de création de membres

Par commodité, nous pouvons créer une structure organisationnelle départementale, ce qui est un préalable au développement, car la gestion de notre carnet d'adresses repose également sur une structure organisationnelle, comme ci-dessus Le niveau de structure organisationnelle présenté dans cet article est le même. Ici, je crée une structure racine de Guangzhou Aiqidi, puis j'y crée des structures organisationnelles, comme le montre la figure ci-dessous.

Vous pouvez ajouter des personnes via des opérations fonctionnelles en arrière-plan. Cet article présente principalement comment appeler l'API du compte WeChat Enterprise pour les opérations de gestion du personnel.

La définition API du créateur est la suivante.

• Instructions de demande

Méthode de demande HTTPS : POST

https://qyapi.weixin.qq. com/cgi-bin/user/create?access_token=ACCESS_TOKEN

La structure du package de requête est :

{
   "userid": "zhangsan",
   "name": "张三",
   "department": [1, 2],
   "position": "产品经理",
   "mobile": "15913215421",
   "gender": 1,
   "tel": "62394",
   "email": "zhangsan@gzdev.com",
   "weixinid": "zhangsan4dev"
}

• Description du paramètre

参数	必须	说明
access_token	是	调用接口凭证
userid	是	员工UserID。对应管理端的帐号，企业内必须唯一。长度为1~64个字符
name	是	成员名称。长度为1~64个字符
department	否	成员所属部门id列表。注意，每个部门的直属员工上限为1000个
position	否	职位信息。长度为0~64个字符
mobile	否	手机号码。企业内必须唯一，mobile/weixinid/email三者不能同时为空
gender	否	性别。gender=0表示男，=1表示女。默认gender=0
tel	否	办公电话。长度为0~64个字符
email	否	邮箱。长度为0~64个字符。企业内必须唯一
weixinid	否	微信号。企业内必须唯一

• Description de l'autorisation

L'administrateur doit disposer de l'autorisation d'interface pour "faire fonctionner le carnet d'adresses" et de l'autorisation de gestion du service désigné.

• Résultat renvoyé

{
   "errcode": 0,
   "errmsg": "created"
}

En C#, nous devons définir l'interface correspondante, puis construire les informations d'entité de transfert correspondantes selon les besoins .

Ici, j'ai défini toutes les interfaces pour la gestion du personnel. Les définitions des interfaces sont les suivantes.

        #region 部门成员管理        /// <summary>
        /// 创建成员        /// </summary>
        CommonResult CreateUser(string accessToken, CorpUserJson user);        /// <summary>
        /// 更新成员        /// </summary>
        CommonResult UpdateUser(string accessToken, CorpUserUpdateJson user);        /// <summary>
        /// 删除成员        /// </summary>
        CommonResult DeleteUser(string accessToken, string userid);        /// <summary>
        /// 根据成员id获取成员信息        /// </summary>
        CorpUserGetJson GetUser(string accessToken, string userid);        /// <summary>
        /// 获取部门成员        /// </summary>
        CorpUserListJson GetDeptUser(string accessToken, int department_id, int fetch_child = 0, int status = 0);        #endregion

Créez ensuite un objet d'entité CorpUserJson qui contient des informations sur le personnel en fonction de la définition des informations. Le code d'opération d'implémentation pour la création de personnel est le suivant.

        /// <summary>
        /// 创建成员        /// </summary>
        public CommonResult CreateUser(string accessToken, CorpUserJson user)
        {            string urlFormat = "http://www.php.cn/{0}";            var data = new
            {
                userid = user.userid,
                name = user.name,
                department = user.department,
                position = user.position,
                mobile = user.mobile,
                gender = user.gender,
                tel = user.tel,
                email = user.email,
                weixinid = user.weixinid
            };            var url = string.Format(urlFormat, accessToken);            var postData = data.ToJson();            return Helper.GetCorpExecuteResult(url, postData);
        }

2. Opération de mise à jour des membres

Opération de mise à jour des membres L'opération de mise à jour des données est similaire à l'opération de création, et son numéro d'entreprise est défini comme suit.

• Instructions de demande

Méthode de demande HTTPS : POST

https://qyapi.weixin.qq. com/cgi-bin/user/update?access_token=ACCESS_TOKEN

L'exemple de package de requête est le suivant (si un champ non obligatoire n'est pas spécifié, la valeur de paramètre précédente du champ ne sera pas mise à jour) :

{
   "userid": "zhangsan",
   "name": "李四",
   "department": [1],
   "position": "后台工程师",
   "mobile": "15913215421",
   "gender": 1,
   "tel": "62394",
   "email": "zhangsan@gzdev.com",
   "weixinid": "lisifordev",
   "enable": 1
}

Étant donné que ses données de fonctionnement sont similaires, son code d'implémentation est également similaire, comme indiqué ci-dessous.

        /// <summary>
        /// 更新成员        /// </summary>
        public CommonResult UpdateUser(string accessToken, CorpUserUpdateJson user)
        {            string urlFormat = "http://www.php.cn/{0}";            //string postData = user.ToJson();
            var data = new
            {
                userid = user.userid,
                name = user.name,
                department = user.department,
                position = user.position,
                mobile = user.mobile,
                gender = user.gender,
                tel = user.tel,
                email = user.email,
                weixinid = user.weixinid,
                enable = user.enable
            };            var url = string.Format(urlFormat, accessToken);            var postData = data.ToJson();            return Helper.GetCorpExecuteResult(url, postData);
        }

3. Suppression de membres, Acquisition de membres, Opérations d'acquisition des membres du département

Ces opérations sont similaires à celles ci-dessus et ne seront pas décrites en détail. L'essentiel est de définir leurs informations de données de retour correspondantes selon les besoins. , puis analysez les données Json en entité correspondante.

1) La définition de personne de suppression est la suivante :

• Demande d'instructions

Méthode de requête HTTPS : GET

https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=lisi

• Description du paramètre

参数	必须	说明
access_token	是	调用接口凭证
userid	是	员工UserID。对应管理端的帐号

• 返回结果

{
   "errcode": 0,
   "errmsg": "deleted"
}

2）成员的获取定义如下：

• 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=lisi

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
userid	是	员工UserID

• 返回结果

{
   "errcode": 0,
   "errmsg": "ok",
   "userid": "zhangsan",
   "name": "李四",
   "department": [1, 2],
   "position": "后台工程师",
   "mobile": "15913215421",
   "gender": 1,
   "tel": "62394",
   "email": "zhangsan@gzdev.com",
   "weixinid": "lisifordev",  
   "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
   "status": 1
}

3）部门成员的获取定义如下：

• 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=1&fetch_child=0&status=0

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
department_id	是	获取的部门id
fetch_child	否	1/0：是否递归获取子部门下面的成员
status	否	0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加

• 权限说明

管理员须拥有’获取部门成员’的接口权限，以及指定部门的查看权限。

• 返回结果

{
   "errcode": 0,
   "errmsg": "ok",
   "userlist": [
           {
                  "userid": "zhangsan",
                  "name": "李四"
           }
     ]
}

这个返回值我们定义一个实体对象用来存储数据即可。

    /// <summary>
    /// 获取部门成员返回的数据    /// </summary>
    public class CorpUserListJson : BaseJsonResult
    {        public CorpUserListJson()
        {            this.userlist = new List<corpusersimplejson>();
        }        /// <summary>
        /// 返回的错误消息        /// </summary>
        public CorpReturnCode errcode { get; set; }        /// <summary>
        /// 对返回码的文本描述内容        /// </summary>
        public string errmsg { get; set; }        /// <summary>
        /// 成员列表        /// </summary>
        public List<corpusersimplejson> userlist { get; set; }
    }</corpusersimplejson></corpusersimplejson>

 

7、综合例子调用代码

上面介绍了一些企业号的接口定义和我对API的C#封装接口和部分实现代码，实现了功能后，我们就可以在代码中对它进行测试，确信是否正常使用。

        /// <summary>
        /// 人员管理综合性操作（创建、修改、获取信息、删除）        /// </summary>
        /// <param>
        /// <param>
        private void btnCorpUser_Click(object sender, EventArgs e)
        {
            CorpUserJson user = new CorpUserJson();
            user.userid = "test";
            user.name ="测试用户";
            user.department = new List<int>(){2};
            user.email = "test@163.com";

            ICorpAddressBookApi bll = new CorpAddressBookApi();
            CommonResult result = bll.CreateUser(token, user);            if (result != null)
            {
                Console.WriteLine("创建成员:{0} {1} {2}", user.name, (result.Success ? "成功" : "失败"), result.ErrorMessage);                string name = "修改测试";
                user.name = name;
                CorpUserUpdateJson userUpdate = new CorpUserUpdateJson(user);
                result = bll.UpdateUser(token, userUpdate);                if (result != null)
                {
                    Console.WriteLine("修改名称:{0} {1} {2}", name, (result.Success ? "成功" : "失败"), result.ErrorMessage);
                }

                CorpUserGetJson userGet = bll.GetUser(token, user.userid);                if (userGet != null)
                {
                    Console.WriteLine("成员名称:{0} ({1} {2})", userGet.name, user.userid, user.email);
                }

                result = bll.DeleteUser(token, user.userid);                if (result != null)
                {
                    Console.WriteLine("删除成员:{0} {1} {2}", name, (result.Success ? "成功" : "失败"), result.ErrorMessage);
                }
            }
        }</int>

获取部门人员的操作代码如下所示。

        /// <summary>
        /// 获取部门人员        /// </summary>
        private void btnCorpUserList_Click(object sender, EventArgs e)
        {            int deptId = 1;
            ICorpAddressBookApi bll = new CorpAddressBookApi();
            CorpUserListJson result = bll.GetDeptUser(token, deptId);            if (result != null)
            {                foreach(CorpUserSimpleJson item in result.userlist)
                {
                    Console.WriteLine("成员名称:{0} {1}", item.name, item.userid);
                }
            }
        }

 

人员的管理，相对来说比较简单，主要是在一定的部门下创建人员，然后也可以给标签增加相应的人员，基本上就是这些了，不过一定需要确保有相应的权限进行操作。

更多Développement C# du portail WeChat et application du développement de la gestion du carnet dadresses des comptes dentreprise WeChat et de la gestion des membres相关文章请关注PHP中文网！