利用腾讯企业邮箱开放API获取账户未读邮件数初探

公司一直使用腾讯提供的免费企业邮箱服务，今天用管理员帐户登录后发现，原来现在腾讯的企业邮箱也开放了部分API

你可以通过开放接口实现以下功能：

• 数据同步

  数据同步可以帮助你同步部门成员信息，你还可以创建、删除、修改帐号信息。

• 来信提醒

  新邮件将即时在OA等办公系统提醒你。

• 单点登录

  你可以从公司OA系统、网站一键进入企业邮箱，免去登录过程。

具体的功能可以自己登陆腾讯企业邮箱管理员界面，进入“工具箱--开放协议”中下载开放协议文档查看，有了这些API就能做不少事情了，可以尝试和公司内部的一些系统进行整合，相信会有意想不到的惊喜。

简单测试了一下未读邮件数这个能力，代码很简单，就不做说明了，由于API返回的数据是JSON格式，用到了LitJSON

         /// <summary>
         /// POST时用到的几个数据
         /// </summary>
         public struct PostData
         {
             /// <summary>
             /// 目标服务器地址
             /// </summary>
             public string url;
             /// <summary>
             /// 采用的编码
             /// </summary>
             public string encoding;
             /// <summary>
             /// POST的数据
             /// </summary>
             public string contentData;
             /// <summary>
             /// contentType
             /// </summary>
             public string contentType;
             /// <summary>
             /// 添加其他的Header
             /// </summary>
             public string header;
         }

         /// <summary>
         /// 申请腾讯企业邮箱时的管理员账户
         /// </summary>
         string client_id = "hhhhhhhhhhh.com";
         /// <summary>
         /// 腾讯企业邮箱分配的接口key
         /// </summary>
         string client_secret = "3ed4b10okd37f2e0f56f23a3b6e53013";
         /// <summary>
         /// 目标邮箱的账户，获取对应的未读邮件数
         /// </summary>
         string alias = "chen123@hhhhhhhhhhh.com";

         /// <summary>
         /// 按钮事件，调用腾讯API获取Token，然后获取未读邮件数
         /// </summary>
         /// <param name="sender"></param>
         /// <param name="e"></param>
         private void bNewMailCount_Click(object sender, EventArgs e)
         {
             //第一步获取Token
             PostData pdata = new PostData();
             pdata.url = "https://tel.exmail.qq.com/cgi-bin/token";
             pdata.contentData = "grant_type=client_credentials&client_id=" + client_id + "&client_secret=" + client_secret;
             pdata.encoding = "UTF-8";
             pdata.contentType = "application/x-www-form-urlencoded";

             string responseString = "";
             //获取token_type和access_token
             LitJson.JsonData json = this.Post(pdata, out responseString);

             if (json != null)
             {
                 //获取Token成功后，第二步，获取未读邮件数
                 pdata = new PostData();
                 pdata.url = "http://openapi.exmail.qq.com:12211/openapi/mail/newcount";
                 pdata.contentData = "alias=" + alias;
                 pdata.encoding = "UTF-8";
                 pdata.contentType = "application/x-www-form-urlencoded";
                 pdata.header = "Authorization: " + json["token_type"] + " " + json["access_token"];

                 responseString = "";
                 json = this.Post(pdata, out responseString);

                 if (json != null)
                 {
                     responseString = "账户：" + json["Alias"] + " 未读邮件：" + json["NewCount"];
                     iHandler.TextBoxAppend(this.tResponse, responseString, true);
                 }
             }
         }
         /// <summary>
         /// POST，返回LitJson.JsonData对象
         /// </summary>
         /// <param name="pdata"></param>
         /// <param name="responseString"></param>
         /// <returns></returns>
         private LitJson.JsonData Post(PostData pdata, out string responseString)
         {
             responseString = String.Empty;
             try
             {
                 Encoding encoding = Encoding.GetEncoding(pdata.encoding);
                 byte[] data = encoding.GetBytes(pdata.contentData);
                 HttpWebRequest webReq = (HttpWebRequest)WebRequest.Create(pdata.url);
                 webReq.Method = "POST";
                 webReq.ContentLength = data.Length;
                 webReq.ContentType = pdata.contentType + "; charset=" + pdata.encoding;
                 if (!String.IsNullOrEmpty(pdata.header))
                 {
                     webReq.Headers.Add(pdata.header);
                 }
                 Stream webStream = webReq.GetRequestStream();
                 webStream.Write(data, , data.Length);

                 WebResponse webResp = webReq.GetResponse();
                 Stream webRespStream = webResp.GetResponseStream();
                 StreamReader reader = new StreamReader(webRespStream, encoding);
                 string respXml = reader.ReadToEnd();
                 reader.Close(); reader.Dispose();
                 webResp.Close();

                 responseString = respXml;
                 return LitJson.JsonMapper.ToObject(respXml); ;
             }
             catch (Exception ex)
             {
                 responseString = ex.ToString();
                 return null;
             }
         }