使用教程

一、注册自己的api key

登录进入 azure ，登录账号使用你的e5账户 ，就是以xxx.onmicrosoft.com开头的的账户。 搜索“应用注册”

2021-03-15：

现在不能直接搜索到了，目前两种方法可以找到 应用注册

1）请搜索 “Azure Active Directory”，然后在 管理-应用注册 ，

2）或者直接点击直达链接：

https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps

点击 新注册 名称随意取一个，但是最重要的是 “重定向 URI (可选)”，请填写为下列地址，不然程序收不到回调。

https://e5.qyi.io/outlook/auth2/receive

2020-03-02 15:32 小伙伴们注意了，这里**受支持的账户类型 重定向 URI (可选)**一定要填对，不然无法授权的哦。

3）点击注册后记录以下信息:

1、应用程序(客户端)ID 2、客户端密码

应用程序(客户端)ID: 创建客户端密码：

2021-03-07 ：

最近很多同学反应授权报错 Invalid client secret is provided. 这里请注意了，客户端密码请复制 “值”，不要复制 ID。

2021-08-19：

客户端密码这里已经没有了“从不”，只能选2年。(别在意这些，谁也不知道2年后微软的策略会不会变，2年换一次密钥也不麻烦)

保存好以上2个key，一会需要用到。 配置api权限 勾选一下四个选项后，同时点击 代表XX授予管理员同意 PS: 这一步如果用的是子账号创建的api，那么这一项是灰色的，不能点击。需要登录 管理员 账号，再点击 代表XX授予管理员同意 这个时候api的配置就算完成了

二、添加key到自动订阅程序

进入 https://e5.qyi.io/ 这里需要github账户登录，同样的，我只能获取你在 github中的 用户id、用户名等基础信息(邮箱获取不了)，其他的任何信息也获取不到(可自行尝试注册一个github Apps测试)。

登录后进入主页面

点击 新建

名称随意输入，只是个标识而已 描述可空

点击 配置

填入上一步记录的 **应用程序(客户端)ID、客户端密码 ** client_id ->应用程序(客户端)ID client_secret->**客户端密码 **

点击下一步进行配置调用时间，

• 说明：单位 秒（最低调用频率为 60 秒,最高为6小时），例如: 30-60,代表在30秒-60秒之间随机调用一次

再点击下一步，到了 授权 ， 此时会跳转到 microsoftonline Auth2.0授权页面，在这里请注意使用同一个域下的空账号(子账号)进行授权。 (因为在这一步我能获取到授权的outlook账户 邮件，但是程序不会保存，仅仅是调用api。)以免在以后发生误会。 点击 接受 后，将会跳转回自动订阅程序。 到此时，授权就完成了。

三、下一步

已经没啦~ 到这里你就可以不用管了，程序会每两个小时调用一次outlook的api。

四、FAQ

Q： 日志是空的

A： 如果是新加入的账户，请等待系统自动调用。

Q： 参数错误

A： 如果 应用id 与 密钥 都没有错误的情况下，那么创建的时候看一下 “任何组织目录（任何Azure AD目录-多租户）中的帐户和个人Microsoft 帐户（例如，Skype、Xbox）” 有没有选这个

Q： 什么时候续期

A: 最后一个月中的任意一天会进行续期，目前是微软程序检测活跃情况，人工点击“一键续期”？？？

Q: REST API is not yet supported for this mailbox.

A:创建子账号的时候需要给outlook许可。

Q: 显示 此订阅处于非活动状态，将很快过期

A:这个提示是少于30天就会显示，并非根据活跃情况显示的。

Q: 过期了怎么办

A: 在过期后的2个月内订阅还是可以用的，所以可以在2个月内取回数据。如果在过期1个月都还没有续订的话，那么就可以开始转移数据了。

Q: 续期历史

2020-04-28 续期一次 2020-06-26 续期一次 貌似从 6月26日开始后，基本上每天都会检测订阅，难道现在不用 人工点击“一键续期”了？

五、注意问题

1. 如果是在到期一个月调用，那么请用管理员账户登录，因为这个时候除了管理员能登录outlook以外，其他的子账户都不行!

六、关闭双重验证