对接腾讯企业邮箱（授权免登，获取未读邮件数量）

温馨提示：企业邮箱必须是专业版的才行，基础版的升级成专业版再对接吧

第一步：获取access_token

接口地址： https://api.exmail.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect

参数	必须	说明
corpid	是	企业id
corpsecret	是	应用的凭证密钥

权限说明

每个应用有不同的secret，代表了对应用的不同权限

返回结果

{
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

参数	说明
access_token	获取到的凭证。长度为64至512个字节
expires_in	凭证的有效时间（秒）

出错返回示例

{
   "errcode": 40001,
   "errmsg": "invalid credential"
}

 

第二步 ：获取登录企业邮箱的地址（一键登录，首次需要用户输入用户名密码进行验证授权）

提示： 链接中的userid 指的是企业邮箱的登录账号（！！！划重点，当时为了这个差点跟客服吵起来），修改密码或者重置CorpSecret都会取消授权关系

请求说明：

HTTPS请求方式： GET

请求地址： https://api.exmail.qq.com/cgi-bin/service/get_login_url?access_token=ACCESS_TOKEN&userid=USERID

参数说明：

参数	必须	说明
access_token	是	令牌
userid	是	用户企业邮箱登录账号

返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
	"login_url": "https://exmail.qq.com/cgi-bin/login?fun=bizopenssologin&method=openapi&userid=zhangsanp@gzdev.com&authkey=XXXX",
	"expires_in": 300,
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
login_url	登录跳转的url，一次性有效，不可多次使用。 如需使用个性域名的，请将https://exmail.qq.com替换成相应的域名即可，并使用http协议。
expires_in	url有效时长，单位为秒

第三步 ： 获取未读邮件数量

请求说明：

HTTPS请求方式： GET

请求地址： https://api.exmail.qq.com/cgi-bin/mail/newcount?access_token=ACCESS_TOKEN&userid=USERID

请求包结构体为：

{
	"type": 0,
	"begin_date": "2016-10-01",
	"end_date": "2016-10-07"
}

参数说明：

参数	必须	说明
access_token	是	令牌
userid	是	用户企业邮箱登录账号
begin_date	是	开始日期。格式为2016-10-01
end_date	是	结束日期。格式为2016-10-07

权限说明

系统应用须拥有指定成员的查看权限。

返回结果

{
	"errcode": 0,
	"errmsg": "ok",
	"count": 1
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
count	未读邮件数

大坑提示：

单点登录和获取未读邮件时corpsecret不一样，需要单独获取token