Skip to content
RemindCash

Tasa límite

Cuantas solicitudes puede hacer cada clave de API y cómo manejar 429 respuestas.

Situación de la API pública

La API v1 utiliza las teclas de portador con un sistema operativo y requiere un período de plan activo. Los puntos finales de facturación y borrado no envían mensajes de clientes. Ejemplos usan los marcadores de posición — nunca pegan una clave real en código compartido.

Límites

Cada clave de API puede hacer solicitudes 60 por minuto. El límite se cuenta por clave, por lo que las teclas separadas tienen presupuestos separados.

El período de prueba activo, Basic o Pro también tiene una asignación total de solicitud de API. Solicitudes que lo consumen se cuentan por empresa y período. Sin un período activo, las solicitudes de datos protegidas devuelven 403 forbidden; después de su el subsidio está agotado, regresan 429 rate_limited. GET /v1/usage reporta la asignación actual sin consumirla. El límite de 60/minuto de la llave sigue vigente.

Cuando golpeas el límite

La API responde con 429 Too Many Requests, el cuerpo de error estándar y un encabezado Retry-After con el número de segundos para esperar.

JSON
{
    "error": {
        "code": "rate_limited",
        "message": "Too many requests."
    },
    "request_id": "0c998db5-ab69-49f5-8058-227973e19dbc"
}

Permanecer dentro del límite

  • Espera a Retry-After antes de reintentar, y añade jitter si varios trabajadores comparten una llave.
  • Utilice per_page hasta 100 para leer más artículos por solicitud.
  • Dar sistemas separados claves separadas para que una integración ocupada no desacelere otra.