了解 API 限制

已完成

为了管理 Business Central SaaS 服务器的性能,Microsoft 对 API 的使用进行了限制。 应注意这些限制,以便在使用 API 进行连接时优化代码。 这些限制也适用于 OData 和 SOAP Web 服务。 具体限制如下:

  • 请求数量。 每个用户或服务主体可以在五分钟的滑动窗口中最多提交 6,000 个请求。 超过此限制时,会返回 HTTP 响应代码 429 - 请求过多 ,因此集成应使用冷却期实现重试逻辑。

  • 当请求的运行时间超过 10 分钟时,将发生超时。

  • 最大并发请求数量为 100。

  • 每个页面只能包含 20,000 个实体。

  • 操作超时设置为 8 分钟。

  • $batch请求最多可以包含 100 个操作。

要减少来自客户端或集成的调用数量并缩短运行时间,请使用以下方法:

  • Webhook 应在变更发生时收到通知。 当实体发生更改时,您的应用程序可以收到推送消息,无需您每隔几分钟检查更改情况。 尝试将解决方案从拉取模式转换为推送模式。 如果此选项不可行,可以应用其他建议。

  • 使用批处理功能在一次调用中执行多个操作。

  • 使用 $filter OData 筛选器表达式减少返回的实体数量。

  • 在一个请求中使用 $expand OData 筛选器表达式检索相关实体。

  • 发布数据时,还可以使用深度插入。 您可以在一个请求中发送详细信息。 创建新销售订单时,您可以在同一个 POST 请求中发送所有销售订单行,并通过一次调用将其全部创建。