第⼀步:获取access_token
参数必须说明
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
参数说明:
参数必须说明
access_token是令牌
userid是⽤户登录账号
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"login_url": "exmail.qq/cgi-bin/login?fun=bizopenssologin&method=openapi&userid=zhan
gsanp@gzdev&authkey=XXXX", "expires_in": 300,
}
参数说明:
参数说明
errcode返回码
errmsg对返回码的⽂本描述内容
login_url 登录跳转的url,⼀次性有效,不可多次使⽤。
如需使⽤个性域名的,请将exmail.qq替换成相应的域名即可,并使⽤http协议。
expires_in url有效时长,单位为秒
第三步:获取未读邮件数量
请求说明:
HTTPS请求⽅式: GET
请求包结构体为:
{
"type": 0,
"begin_date": "2016-10-01",
"end_date": "2016-10-07"
}
参数说明:
参数必须说明
修改密码qqaccess_token是令牌
userid是⽤户登录账号
begin_date是开始⽇期。格式为2016-10-01 end_date是结束⽇期。格式为2016-10-07权限说明
系统应⽤须拥有指定成员的查看权限。
返回结果
{
"errcode": 0,
"errmsg": "ok",
"count": 1
}
参数说明
errcode返回码
参数说明
errmsg对返回码的⽂本描述内容count未读邮件数
⼤坑提⽰:
单点登录和获取未读邮件时corpsecret不⼀样,需要单独获取token
发布评论