Límites de solicitudes


Los límites evitan que una integración con mucha actividad ralentice a todos los demás. Cada sitio tiene sus propios límites para cada solicitante, por lo que el tráfico hacia un sitio nunca agota los límites de otro.


Solicitudes a un sitio

Cada solicitud a un sitio, en site/{site_id}/, cuenta para estos tres límites:

  • 50 solicitudes en cualquier lapso de 5 segundos
  • 250 solicitudes por minuto
  • 5,000 solicitudes por hora

Superar un límite bloquea las siguientes solicitudes a ese sitio durante 1 minuto, o durante 1 hora cuando se trata del límite por hora. Una solicitud bloqueada recibe HTTP 429 y esta respuesta:

Respuesta de límite de solicitudes
			
{
  "success": false,
  "errors": [
    "Please wait before trying again."
  ]
}


		

Todas las solicitudes desde una misma dirección IP, a cualquier sitio, también comparten un límite de 5,000 por minuto. Excederlo bloquea esa dirección durante 3 minutos, con HTTP 429 y el mensaje The request limit has been exceeded. Please wait before sending more.


Lectura de registros

Los endpoints Get y List tienen un límite más: 10 solicitudes en 5 minutos a la misma URL, por cada sitio y cada solicitante. Aquí la cadena de consulta no forma parte de la URL, por lo que todas las páginas de una lista cuentan para las mismas 10. Superarlo bloquea esa URL durante 5 minutos, con el mensaje Access to this resource has been throttled. Please wait before trying again.

Solicitar un registro que no existe cuenta como dos solicitudes para cada uno de los límites anteriores.

Get Payment funciona de forma distinta: no tiene ninguna de estas reglas y, en cambio, cada pago se puede leer una vez cada 55 segundos. Cada id con el que lo lea cuenta por separado. Leer el mismo pago de nuevo antes de ese tiempo devuelve HTTP 400 con success en false y el mensaje You have hit the throttle limit for this payment, please try again in a minute


Tamaño de la solicitud

El cuerpo de una solicitud puede ser de hasta 1 MB de JSON. Un cuerpo más grande recibe HTTP 413 y Request body too large. Volver a enviarlo falla de la misma manera, así que divídalo en solicitudes más pequeñas.


Cómo mantenerse dentro de los límites

  • Distribuya las cargas masivas en lugar de enviarlas todas a la vez.
  • Use webhooks para enterarse de los pagos en lugar de consultarlos una y otra vez.
  • Cuando reciba un 429, espere a que termine el bloqueo antes de enviar más solicitudes.

Consulte Errores para ver todos los códigos de estado.