对接腾讯企业邮箱(授权免登,获取未读邮件数量)

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

第一步:获取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

你可能感兴趣的:(对接腾讯企业邮箱(授权免登,获取未读邮件数量))