腾讯企业邮箱OpenApi协议v1.3.docxVIP

腾讯企业邮箱OpenApi协议v1.3 BizMail OpenApi协议——面对企业邮用户名目 (22) 名目................................................................................................................................................... (33) 一、开放协议介绍...........................................................................................................................1.1功能简介 (3)1.2协议格式 (3)1.3平安机制 (3)1.4协议编码 (3)二、接入流程................................................................................................................................... (33) 2.1管理端申请 (4)2.2猎取接口key (4)2.3OAuth验证受权 (5)2.4调用Api〔客户端恳求〕 (7) (77) 三、调用API说明..........................................................................................................................3.1单点登录 (7)3.1.1猎取Authkey (7)3.1.2一键登录 (8)3.2邮件提示 (9)3.2.1客户端维持长连接 (9)3.2.2版本号更新 (10)3.2.3新邮件提示 (10)3.2.4实时更新未读邮件数 (11)3.3数据同步 (11)3.3.1猎取成员资料 (11)3.3.2同步成员帐号资料 (13)3.3.3猎取某个版本号后的用户更新列表 (14)3.3.4猎取未读邮件数 (15)3.3.5同步部门 (16)3.3.6猎取子部门列表 (17)3.3.7猎取部门下成员列表 (18)3.3.8检查邮件帐号是否可用 (18)3.3.9添加邮件群组 (18)3.3.10删除邮件群组 (18)3.3.11添加邮件群组成员 (18)3.3.12删除邮件群组成员 (18)19 (19)四、附录：名词说明.....................................................................................................................一、开放协议介绍1.1功能简介腾讯企业邮箱开放协议，包括面对第三方合作应用和面对企业邮用户两类。其中，面对企业邮用户的开放协议，将供应给企业邮用户丰富的应用接口，用户可以依据这些接口定制自己统一的企业解决方案。通过协议接口，企业用户可以实现：1)单点登录可以从公司OA系统、网站一键进入企业邮箱，免去登录过程。2)新邮件提示新邮件将即时在OA等办公系统提示你。3)数据同步数据同步可以关心你同步部门成员信息，你还可以创立、删除、修改帐号，同步部门信息等。1.2协议格式协议采纳HTTP+JSON格式，恳求采纳GET/POST方式。1.3平安机制1)管理员在管理端可以随时启用/关闭同步选项。2)在管理端的“操作记录〞可以查询同步日志，便利观看异样。1.4协议编码均用UTF-8编码。二、接入流程接入腾讯企业邮开放接口的全流程图如下：2.1管理端申请从链接http://.doczj/doc/9ee181b480eb6294dc886c5e.html 进入，用法管理员账号登录进入管理页面，翻开“工具箱-开放协议〞，点击“马上申请〞。2.2猎取接口key接口key，是作为下一步OAuth验证受权传递的参数，需要查看明文。〔1〕点击“查看明文〞：〔2〕输入管理员密码，点击“确定〞〔3〕可查看接口key截图中的接口key 为563a8c6a89d2368194c1c7889c508b342.3OAuth 验证受权接口说明：目前，腾讯企业邮箱采纳OAuth2.0协议对第三方进展受权，关于OAuth2.0的具体介绍，请参考OAuth 协议标准。客户端通过长连接维持在线状态，效劳端通过检查用户的在线状态，实时推送消息；同时客户端依