Dynamics 365 Online-60000 API Limits

最近，Dynamics 365官方文档有最新的发布，就是从2018.3.19开始，会对API请求的数目有个限制：在连续的5分钟里，一个连接用户，针对一个CRM Organization，API请求数不能超过60000。因为还没有正式实行，所以我们先从文档上来理解这个限制。

一. 理解API Limitation

虽然“在连续的5分钟里，一个连接用户，针对一个CRM Organization，API请求数不能超过60000”这个描述说的很简单易懂，但是我们还是需要更加深入地了解下到底是怎样的情况。接下来，我们以“什么人在什么时间做了什么”为模板来拆分理解这个限制。

1. 什么人

一个连接用户。

限制针对所有的授权账户（Licensed User），所以目前来看不会有特殊账户跳出这个限制，限制起效果的对象是每个连接账户（Connection User）；

涉及到的Dynamics 365版本：Online V8.x和Online V9.x

2. 什么时间

连续的5分钟里。

这个时间是从账号连接上就开始计算，然后不停的在统计API请求

3. 做了什么

API请求不得超过60000。

API请求不单单是.Net代码后台请求，还包括Form JavaScript请求；

60000/300s=200/s，也就是说在限制的时间段里，每秒的请求不超过200；

Multiple API Request只算一次请求，例如.Net Assembly中的ExecuteMultipleRequest，ExecuteTransactionRequest；Web API $batch

4. 如果超过限制呢？

首先，如果超过限制，之后的API请求会有怎样呢？

.Net assemblies会抛出异常，Error Code是-2147015902，异常信息Number of requests exceeded the limit of 60000, measured over time window of 300 seconds；

Http请求会在Response中返回StatusCode：429，Message：Number of requests exceeded the limit of 60000, measured over time window of 300 seconds.

其次，如果超过限制，是不是就不能发请求了？

在一定时间内，要停止发API请求的操作，需要等Request Volumn降到限制数之下以后，才可以继续发送。Request Volumn降到限制数之下的时间不是很明确，可以考虑等5分钟之后再发请求，但最终还得看实际情况。

二.限制的影响及目前的解决方案

从理解上看，如果想超过限制，那么在连续的5分钟里，一个用户需要每秒发200次API请求。考虑网络等因素，Dynamics 365的日常使用是完全不受影响的，可能波及的情况是在某个时间段里，需要集成同步大量的数据，这个时候，就会有大量的API请求。如果真的遇到这样的情况，应该怎么办呢？

1. 如果情况不是很紧急或者很严重，可以等后续的更新。在3.19之后的一周到两周里，可能会有后续相关的更新

2. 考虑减少并行的线程来减少请求数

3. 考虑提高一次请求的执行数量，变相的减少请求数，但是这时还需要考虑Service超时情况

4. 考虑增加执行账户的个数。因为限制是针对每个连接账号的，所以可以增加多个连接账户来分摊60000的限制

以上对官方资料的一个总结，具体的英文参考资料：

https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/api-limits#what-should-i-do-if-my-application-exceeds-the-limit

https://www.kingswaysoft.com/blog/2018/02/27/How-to-Cope-with-the-new-Dynamics-365-API-Limits