Errores

Author profile photo
Equipo Quickex
29 de agosto de 2025
~1 lectura mínima

2xx Success

4xx Client Error

5xx Server Error

Quickex utiliza códigos HTTP estándar para indicar el resultado de una solicitud:
2xx — éxito,
4xx — error en los datos/permisos de la solicitud,
5xx — error del lado del servidor (raro).

Algunos códigos 4xx incluyen un breve
error.code y un mensaje para el manejo programático.

Recomendaciones de manejo

  • Registre el HTTP status y el cuerpo de la respuesta.
  • Para 429 y 5xx temporales, use reintentos con backoff exponencial (backoff + jitter).
  • Valide los parámetros obligatorios antes de enviar la solicitud.

Código Nombre Descripción
200 OK Todo funcionó como se esperaba.
400 Bad Request Solicitud no válida (a menudo falta un parámetro obligatorio).
401 Unauthorized No hay un token/clave válido.
402 Request Failed Los parámetros son correctos, pero la operación no se completó.
403 Forbidden Permisos insuficientes para realizar la solicitud.
404 Not Found El recurso no existe.
409 Conflict Conflicto con el estado actual (duplicado, inconsistencia, etc.).
424 External Dependency Failed Fallo de una dependencia externa que impide completar la solicitud.
429 Too Many Requests Se superó el límite: reduzca la frecuencia y aplique backoff.
500, 502, 503, 504 Server Errors Error del lado del servidor. Intente de nuevo más tarde (con backoff).

Resumen informativo
Quickex utiliza códigos HTTP estándar. 2xx — éxito; 4xx — errores de validación/permisos/cliente; 5xx — errores del servidor (raros). Las respuestas 4xx manejables incluyen un código de error y un mensaje. Para 429 y 5xx temporales, use backoff exponencial con jitter. Registre siempre el estado y el cuerpo de la respuesta.
Comparte este artículo: