企业OA页面直接免登邮箱
可以直接在企业自己内部的办公页面上面直接免登跳转到自己的企业邮箱。可以结合未读邮件数使用。
参考《阿里云邮箱免登接入文档》
常见问题及建议：
1.由三方系统调用 邮箱接口，获取 用户 免登token, 然后三方系统带着 token 跳转邮箱的单点页面，可实现免登。
2.三方系统可以提供登录url、登出url, 以便 webmail 登陆、登出时可以跳转到三方页面，如果没有则跳转云邮箱自己的登陆、登出页面。
3.调试的错误提示：[login]req:{"app_code":"md_test","sign":"e818fe310edbebfb54e9e6b37e5dd218","timestamp":"1510651375248","user_id":"utest@taobaotest.com"};resp:{"content":{"errorCode":"1004","errorMsg":"签名错误","success":false},"hasError":false}
get_md_token error;result={"content":{"errorCode":"1004","errorMsg":"签名错误","success":false},"hasError":false}
分析：appCode不对。请使用压缩包里面《接入联调测试AppCode、测试域.txt》下的正确的appCode。如果是线上正式使用，请联系阿里邮箱技术支持获取分配的正确的线上appCode。
2. 阿里企业邮箱API集成准备工作
API对接的准备工作，请参考《API接入使用说明》。
2.1 阿里邮箱账号&组织架构同步
很多企业有自己的账户管理系统及部门架构管理系统，可以通过调用阿里邮箱的API接口实现账户管理和部门数据管理。这样的话，管理员可以在原企业的管理页面操作，底层会通过API同步数据到阿里邮箱。参考文档：《阿里邮箱API二次开发文档-账户&组织架构管理》
阿里邮箱集成常见问题及建议：
1.所有的API都需要使用Token来做鉴权。使用从阿里邮箱分配的accesscode和accesspassword请求WsLogin接口来获取Token。
2.注意http请求header里面指定
content-type：application/json;charset=UTF-8
3.Token一般有效期为24小时，但是因为是内存态，所以建议在base函数里面判断是否返回408错误，如果返回如下错误，可以尝试重新wslogin获取一个新的token。
{
"status": {
"statusMsg": "SYS_REQ_ACCESSTOKEN_INVALID [token:accesscode0013KNzt1492048722640]",
"statusCode": "408"
},
"data": {}
}
4.创建部门的时候需要使用的根部门ID可以使用GetDomainInfo获取rootDepartmentId字段的值。
5.修改用户密码之后注意还要将账户登陆是否要重置密码隐藏：
调用updateAccountPassword接口重置密码
调用updateAccountInfo 接口将账户的initPasswdChanged字段设置成1
2.2获取邮件总数或者未读邮件数
可以通过API获取到指定账户的各个文件夹邮件数目以及未读邮件数。使用比较多的场景是在企业的OA页面后台获取当前登录账户未读邮件数目提醒用户，用户点击后通过免登直接跳转到邮箱界面。参考《阿里邮箱API-获取未读邮件》
常见问题及建议：
1.目前没有直接能返回所有文件夹未读邮件的接口，需要获取所有目录的unread数据自行累加，注意排除如下几个文件夹： 3垃圾箱|5草稿箱|6已删除|8 系统隐藏目录。
2.如果只需要提醒用户收件箱目录的未读邮件数，就只需要返回folderID=2的unread值就可以了
2.3搜索
在OA系统可能需要做一些针对邮件的搜索归类展示的需求，可以使用API调用Search 或者SearchEx接口来实现。参考《阿里邮箱API-搜索》
常见问题及建议：
1.普通搜索使用Search接口就可以满足
2.高级搜索SearchEx接口要注意request的json的逻辑
2.4 邮件投递
在企业内部的一些平台可以通过SMTP协议直接做系统通知邮件投递。参考《阿里邮箱SMTP邮件投递示例》
常见问题及建议：
1.注意阿里邮箱的SMTP需要login后才能做投递。
2.注意login的user需要是带@后缀的全账户名
3.注意非ssl加密端口是25，ssl加密端口是465.
4.阿里邮箱的smtp单个session支持的rcpt收件人上限500人。单个邮件大小限制为50M以内。
5.注意信件内容是正常邮件，否则容易触发内容反垃圾系统封禁。
6.注意发信频率，否则容易触发行为反垃圾的封禁。
!