Descomprimir un ZIP

Por qué un comprimido es una caja negra riesgosa

Un archivo ZIP es una incógnita hasta que se abre, y abrir comprimidos no confiables directamente en producción es la manera más común de terminar con una zip bomb o un ataque de path traversal ('zip slip') documentado en un reporte de incidente. Los equipos que aceptan subidas de usuarios — bibliotecas de medios de un CMS, mercados de plugins, herramientas de importación masiva — necesitan inspeccionar y extraer el contenido en un entorno aislado, para que un archivo malformado o malicioso nunca toque la máquina que corre la aplicación.

Qué hace exactamente el endpoint

POST /data/unzip acepta un comprimido por subida directa o por URL, junto con una operación: list para devolver nombres de archivo, tamaños, ratio de compresión y fechas sin extraer nada, o extract para descomprimir rutas específicas (o todo) y devolver los resultados como archivos individuales detrás de enlaces firmados, o empaquetados en un comprimido nuevo. La llamada devuelve un task_id de inmediato; el trabajo real ocurre de forma asíncrona.

Una breve historia de un formato muy antiguo

El formato ZIP nació en 1989 con PKZIP de PKWARE, diseñado para comprimir archivos en la era de los disquetes. Se volvió un estándar de facto porque su especificación es abierta y cualquier herramienta puede implementarla, razón por la cual hoy aparece en todas partes: documentos de Office (que internamente son ZIPs), paquetes APK de Android, archivos JAR de Java y mods de videojuegos. Nuestro endpoint procesa las mismas entradas basadas en DEFLATE de las que dependen todos esos formatos.

Qué esperar de la respuesta

Listar un comprimido de 500 entradas y extraer tres archivos puntuales suele terminar en bien menos de un segundo de procesamiento real una vez que arranca la tarea; el tiempo de entrega depende de si está sondeando el estado, esperando un webhook o descargando el enlace firmado, que permanece válido durante 24 horas. La estructura de carpetas, los metadatos de permisos y las fechas originales se conservan en la respuesta para que el código que sigue pueda reconstruir la organización exacta del comprimido.

Dónde encaja dentro de un flujo más amplio

Este es un paso, no una tubería completa: combínelo con nuestros endpoints de conversión y procesamiento de archivos para, por ejemplo, descomprimir un paquete de tema, validar el tipo de cada archivo y enviar las imágenes a una tarea de redimensionado y las hojas de estilo a un minificador, todo encadenado desde el mismo webhook. Como las tareas fallidas nunca se cobran, puede conectar esto directamente al manejador de subidas de su aplicación sin preocuparse por pagar por los comprimidos corruptos o vacíos que inevitablemente envían los usuarios.