Manejo de Errores

Todos los errores devuelven un objeto JSON con un campo error:

{
  "error": "not enough storage, please upgrade your plan"
}

Códigos de estado

Código	Significado	Causas comunes
400	Solicitud Incorrecta	Parámetros faltantes o invalidos, tipo de contenido no soportado, cuerpo JSON inválido.
401	No Autorizado	Clave API faltante o inválida.
402	Pago Requerido	Límite de almacenamiento excedido — actualiza tu plan o espera al reinicio mensual.
404	No Encontrado	CID de archivo o usuario no encontrado.
429	Demasiadas Solicitudes	Límite de ancho de banda del gateway excedido — espera al reinicio mensual.
500	Error Interno	Error inesperado del servidor — reintenta o contacta soporte.