Gestión de errores

Nuestra API utiliza códigos de respuesta HTTP estándar para indicar el éxito o el fallo de las solicitudes. Estos son los códigos de error comunes que podrías encontrar y cómo gestionarlos.

Códigos de estado HTTP
200 OK

La solicitud se realizó correctamente.

400 Bad Request

La solicitud no era válida o no se puede atender.

401 Unauthorized

La autenticación falló o no se proporcionó.

403 Forbidden

La solicitud se entiende, pero ha sido rechazada o el acceso no está permitido.

404 Not Found

No se pudo encontrar el recurso solicitado.

429 Too Many Requests

Has superado el límite de uso.

500 Internal Server Error

Algo salió mal por nuestra parte.

Formato de respuesta de error
Todas las respuestas de error siguen este formato:
{
  "error": "error_code",
  "message": "Human-readable error message",
  "details": {}
}
Códigos de error comunes

invalid_api_key: La clave de API proporcionada no es válida.

missing_api_key: No se proporcionó ninguna clave de API.

invalid_ip: La dirección IP proporcionada no es válida.

invalid_domain: El dominio proporcionado no es válido.

rate_limit_exceeded: Has superado tu límite de uso.

quota_exceeded: Has superado tu cuota mensual.

server_error: Se produjo un error interno del servidor.

Buenas prácticas para la gestión de errores

Comprueba los códigos de estado: Comprueba siempre el código de estado HTTP antes de procesar la respuesta.

Gestiona los límites de uso: Implementa una lógica adecuada de espera y reintento para los errores 429.

Registra los errores: Registra información detallada de los errores para facilitar la depuración.

Degradación controlada: Dispón de mecanismos de respaldo para cuando la API no esté disponible.