Límites de peticiones
Cada cuenta tiene un límite de peticiones por minuto. Cuando lo superas, Semantara responde
con AUTH_004 (HTTP 429).
Las respuestas de límite no incluyen un header Retry-After. Implementa una espera
incremental (exponential backoff) al recibir un 429: espera un momento y reintenta,
aumentando la espera si el 429 persiste.
Intentos de autenticación fallidos
De forma independiente, demasiados intentos de autenticación fallidos desde una misma IP
disparan un bloqueo temporal: AUTH_010. Suele indicar una key mal configurada
o truncada — revisa que estés enviando tu key px_live_ completa antes de reintentar.
Buenas prácticas
- Reintenta los 429 (
AUTH_004yAUTH_010) con backoff, nunca en un bucle inmediato. - Distribuye las peticiones en el tiempo en lugar de enviarlas en ráfagas.
- No reintentes errores de validación (
VAL_*) ni de credencial (AUTH_001/002/003): corrígelos antes de reenviar. Ver Códigos de error.