C# .NET 微信企业号通讯录添加成员

  首先来看微信官方的文档

创建成员

  • 请求说明

Https请求方式: POST

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

请求包结构体为:

{
   "userid": "zhangsan",
   "name": "张三",
   "department": [1, 2],
   "position": "产品经理",
   "mobile": "15913215421",
   "gender": "1",
   "email": "[email protected]",
   "weixinid": "zhangsan4dev",
   "avatar_mediaid": "2-G6nrLmr5EC3MNb_-zL1dDdzkd0p7cNliYu9V5w7o8K0",
   "extattr": {"attrs":[{"name":"爱好","value":"旅游"},{"name":"卡号","value":"1234567234"}]}
}
  • 参数说明
参数 必须 说明
access_token 调用接口凭证
userid 成员UserID。对应管理端的帐号,企业内必须唯一。长度为1~64个字节
name 成员名称。长度为1~64个字节
department 成员所属部门id列表
position 职位信息。长度为0~64个字节
mobile 手机号码。企业内必须唯一,mobile/weixinid/email三者不能同时为空
gender 性别。1表示男性,2表示女性
email 邮箱。长度为0~64个字节。企业内必须唯一
weixinid 微信号。企业内必须唯一。(注意:是微信号,不是微信的名字)
avatar_mediaid 成员头像的mediaid,通过多媒体接口上传图片获得的mediaid
extattr 扩展属性。扩展属性需要在WEB管理端创建后才生效,否则忽略未知属性的赋值
  • 权限说明

管理组须拥有指定部门的管理权限。

  • 返回结果
{
   "errcode": 0,
   "errmsg": "created"
}


  以下步骤是建立到已经获取到accessToken,我们开始

首先新建一个类,用来存放数据,大概数据结构。以下代码别复制 自己手动创建实体类
    public String userid;//员工UserID。对应管理端的帐号,企业内必须唯一。长度为1~64个字符
    public String name;//成员名称。长度为1~64个字符
    /**成员所属部门id列表,多个部门请用逗号隔开。

注意,每个部门的直属员工上限为1000个*/ public List department;// public String position;//职位信息。长度为0~64个字符 public String mobile;//手机号码。企业内必须唯一,mobile/weixinid/email三者不能同时为空 public String email;//邮箱。长度为0~64个字符。企业内必须唯一 public String weixinid;//微信号。企业内必须唯一。(注意:是微信号,不是微信的名字) public String enable="1";//启用/禁用成员。1表示启用成员,0表示禁用成员 public String avatar;//头像url。注:如果要获取小图将url最后的"/0"改成"/64"即可 public String status;//关注状态: 1=已关注,2=已冻结,4=未关注 public Extattr extattr;//扩展属性。扩展属性需要在WEB管理端创建后才生效,否则忽略未知属性的赋值



        /// 
        /// 把实体转换为 json
        /// 
        /// 
        public String getUserJsonStr(ViewUserQY qy)
        {
            StringBuilder sBuilder = new StringBuilder();
            sBuilder.Append("{");
            sBuilder.Append("\"userid\": \"" + qy.UserId + "\",");
            sBuilder.Append("\"name\": \"" + qy.Name + "\",");
            StringBuilder dBuilder = new StringBuilder();
            for (int i = 0; i < this.department.size(); i++)
            {
                if (i != 0)
                {
                    dBuilder.Append("," + this.department.get(i).getId());
                }
                else
                {
                    dBuilder.Append(this.department.get(i).getId());
                }
            }
            sBuilder.Append("\"department\": [" + dBuilder + "],");
            sBuilder.Append("\"position\": \"" + qy.Position + "\",");
            sBuilder.Append("\"mobile\": \"" + qy.Mobile + "\",");
            sBuilder.Append("\"email\": \"" + qy.Email + "\",");
            sBuilder.Append("\"weixinid\": \"" + qy.WeixinId + "\",");
            sBuilder.Append("\"enable\": " + 0 + ",");
            sBuilder.Append("\"extattr\": {}");
            sBuilder.Append("}");
            return sBuilder.ToString();
        }
    }

添加成员代码,把实体类的数据转成json格式,然后向微信服务器发送一个post请求。 accessToken 需先拿到
string postUrl = "https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=" + accessToken;
            String jsonStr = getUserJsonStr(entity);
            byte[] bytes = Encoding.UTF8.GetBytes(jsonStr);
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(postUrl);
            request.Method = "POST";
            request.ContentLength = bytes.Length;
            request.ContentType = "text/xml";
            Stream reqstream = request.GetRequestStream();
            reqstream.Write(bytes, 0, bytes.Length);

            //声明一个HttpWebRequest请求
            request.Timeout = 90000;
            //设置连接超时时间
            request.Headers.Set("Pragma", "no-cache");
            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream streamReceive = response.GetResponseStream();
            Encoding encoding = Encoding.UTF8;

            StreamReader streamReader = new StreamReader(streamReceive, encoding);
            string strResult = streamReader.ReadToEnd();
            streamReceive.Dispose();
            streamReader.Dispose();

  总结:把所需要的数据拿到之后,拼装成json数据吗,然后向微信post请求,结果会返回出来

你可能感兴趣的:(C# .NET 微信企业号通讯录添加成员)