Saltar al contenido principal
La API de GetQR está en beta y solo está disponible para algunos espacios de trabajo. Los detalles pueden cambiar antes del lanzamiento general.
La API de GetQR limita cuántas solicitudes puede enviar cada clave de API, para que una sola integración no ralentice la API para todos.

Límites

El límite se cuenta en una ventana deslizante de un minuto y se aplica a todos los endpoints en conjunto. La comprobación de estado no necesita clave y no cuenta.

Cabeceras de límite de tasa

Las respuestas a solicitudes con una clave de API válida incluyen estas cabeceras, también las respuestas de error:

Si superas el límite

Por encima del límite, la API responde 429 con el código rate_limit_exceeded y las mismas cabeceras:
Espera hasta el momento del reinicio antes de enviar más solicitudes. Añade una variación aleatoria (jitter) para que varios procesos no reintenten a la vez, y aplica una espera exponencial ante errores 5xx:
Reintenta POST /api/v1/qrs solo con una cabecera Idempotency-Key. Así, un reintento nunca crea un segundo código QR. Consulta Idempotencia.

No superes el límite

  • Vigila X-RateLimit-Remaining y reduce el ritmo antes de que llegue a 0.
  • Usa la creación masiva de QR en lugar de una solicitud por código QR.
  • Obtén hasta 100 resultados por página con pageSize=100. Consulta Paginación.
  • Guarda en caché las imágenes de QR: las descargas devuelven un ETag, así que puedes enviar If-None-Match y recibir 304 Not Modified si nada ha cambiado.

Siguientes pasos

Errores

Códigos QR