Saltar al contenido principal

Límite de consumo de las APIs(rate limit)

Las APIs de BTG Pactual Empresas imponen un límite de solicitudes, por minuto, para sus APIs.

Esta información, con el fin de permitir que el sistema integrador pueda identificar si se está acercando o no al límite, se pone a disposición vía headers en la respuesta de todas las APIs

HeaderDescripción
X-RateLimit-LimitLímite de solicitudes por minuto dentro de la ventana
X-RateLimit-RemainingSolicitudes restantes en la ventana de solicitudes
X-RateLimit-ResetTimestamp Unix de reinicio de la ventana de solicitudes

El consumo se calcula por clientId que realiza la solicitud. En otras palabras, en caso de que tu sistema consuma un volumen muy alto y tenga solo 1 clientId, es fundamental que se implemente un flujo de verificación de estos valores.

El consumo ocurre independientemente de que la response de la API retorne éxito o error.

En el momento en que se alcance el límite, nuestro sistema retornará el código 429 con el siguiente payload:

{
"limit":120, //Cuota de llamadas por minuto
"reset_in_seconds":4, //Tiempo en segundos para el reinicio de la cuota
"identifier":"1a4b0f90-9e5a-4b51-a097-c88660c19ad4",
"message":"Too many requests. Please try again later."
}