Trabajar con límites de API

  • 5 minutos

Para administrar el rendimiento de los servidores SaaS de Business Central, Microsoft limita el uso de la API. Debe tener en cuenta estas limitaciones para que pueda optimizar el código al conectarse mediante la API. Las limitaciones también se aplican a servicios web OData y SOAP. Las siguientes limitaciones están implementadas:

  • Número de solicitudes. Cada usuario o entidad de servicio puede enviar un máximo de 6000 solicitudes dentro de una ventana deslizante de cinco minutos. Cuando se exceda este límite, se devuelve un código de respuesta HTTP 429 - Too Many Requests, por lo que su integración debe implementar una lógica de reintento con un período de espera.

  • Se produce un tiempo de espera cuando su solicitud supera los 10 minutos de tiempo de ejecución.

  • El número máximo de solicitudes simultáneas es de 100.

  • Una página solo puede contener 20 000 entidades para cada página.

  • El tiempo de espera de la operación se establece en ocho minutos.

  • Una solicitud $batch puede contener un máximo de 100 operaciones.

Para reducir el número de llamadas de un cliente o integración y para reducir el tiempo de ejecución, utilice los siguientes enfoques:

  • Los webhooks deberían recibir notificaciones de cambios cuando se produzcan. Su aplicación puede recibir un mensaje push cuando se modifica una entidad en lugar de que tenga que comprobar los cambios cada pocos minutos. Intente convertir su solución de un modelo pull a uno push. Si esa opción no es posible, puede aplicar otras recomendaciones.

  • Use el procesamiento por lotes para realizar varias operaciones en una sola llamada.

  • Utilice la expresión de filtro de OData $filter para reducir el número de entidades devueltas.

  • Utilice la expresión filtro de OData $expand para recuperar entidades relacionadas en una solicitud.

  • Cuando publique datos, también puede usar Inserciones profundas. Puede enviar detalles en una sola solicitud. Cuando crea un nuevo pedido de ventas, puede enviar todas sus líneas de ventas en la misma solicitud POST y hacer que se creen en una sola llamada.