Compress

Bienvenido a la documentación oficial de Compress, la API ligera pero poderosa diseñada para reducir archivos de hoja de cálculo a una fracción de su tamaño original con una única y sencilla solicitud. En el mundo actual impulsado por los datos, los equipos intercambian constantemente hojas de cálculo que contienen desde listas simples hasta complejos modelos financieros, y el gran volumen de estos archivos puede convertirse rápidamente en un costo oculto: cargas más lentas, mayores tarifas de almacenamiento y tiempos de procesamiento más largos para los sistemas downstream. Compress aborda estos problemas ofreciendo un servicio nativo en la nube que analiza inteligentemente la estructura interna de su hoja de cálculo, elimina la carga innecesaria y vuelve a empaquetar el contenido en una forma optimizada y compacta sin sacrificar la integridad o la legibilidad de los datos. Esta página de documentación sirve como su fuente única de verdad, guiándole a través de todo lo que necesita saber para comenzar a usar la API de manera efectiva, desde la autenticación y el formato de solicitudes hasta el manejo de errores y las mejores prácticas para el procesamiento por lotes. Ya sea que sea un ingeniero backend experimentado integrando pipelines de datos, un desarrollador front‑end que busca mejorar la experiencia del usuario al subir archivos, o un responsable de TI encargado de reducir la sobrecarga de almacenamiento en su organización, esta guía proporcionará instrucciones claras paso a paso, fragmentos de código en varios lenguajes y ejemplos del mundo real que ilustran cómo lograr los mejores resultados de compresión para una amplia variedad de formatos de hoja de cálculo. A lo largo de la documentación encontrará secciones dedicadas a consideraciones de seguridad—como cifrado TLS, tokens JWT firmados y manejo de datos compatible con GDPR—junto con referencias de rendimiento que demuestran la latitud típica y el rendimiento bajo diferentes cargas de trabajo. También incluimos una FAQ extensa que cubre escenarios comunes, una matriz de solución de problemas para diagnóstico rápido de incidencias y enlaces a foros de la comunidad donde puede compartir conocimientos con otros desarrolladores que están utilizando Compress en producción. Al finalizar esta guía, se sentirá confiado al configurar sus entornos, enviar una llamada a la API correctamente formada e interpretar la carga útil de la respuesta, de modo que pueda integrar la compresión sin inconvenientes en sus flujos de trabajo existentes y comenzar a observar ahorros tangibles en costos de almacenamiento y ancho de banda de red de inmediato. Sumérjase, explore las secciones que coincidan con su rol y deje que Compress se encargue del trabajo pesado de la reducción de datos para que pueda centrarse en crear aplicaciones más ricas y receptivas.

Características principales

El núcleo de la API Compress se basa en un amplio conjunto de funcionalidades que hacen que la reducción de hojas de cálculo sea fácil y fiable. En primer lugar, el servicio admite una gran variedad de tipos de archivo —incluidos Apple Numbers, archivos CSV y TSV simples, así como los formatos .xlsx y .xls de Microsoft Excel—, por lo que puede enviar prácticamente cualquier hoja de cálculo que encuentre sin necesidad de un paso de pre‑conversión. Bajo el capó, el motor realiza una optimización multi‑fase: normaliza la estructura interna XML o binaria del archivo, elimina estilos duplicados, fusiona formatos de celda idénticos, elimina filas y columnas ocultas que no contienen datos, y compacta objetos incrustados como imágenes, gráficos y tablas dinámicas aplicando algoritmos de compresión sin pérdida adaptados a cada contenido. Además, la API detecta y elimina metadatos redundantes, comentarios e información de versiones que suelen inflar el tamaño del archivo sin aportar un beneficio funcional. Todas estas operaciones se ejecutan en tiempo real, entregando resultados en milisegundos para archivos de hasta 50 MB, y escalando de forma fluida a documentos más grandes con limitación de velocidad y devoluciones de progreso. La seguridad está integrada: cada solicitud se transmite mediante HTTPS y el servicio nunca conserva una copia de su archivo más allá de la breve ventana de procesamiento, garantizando el cumplimiento de estrictas regulaciones de privacidad. Desde la perspectiva del desarrollador, la API está diseñada para ser lo más libre de fricción posible: un único POST al endpoint `/compress` con el archivo adjunto como multipart/form‑data devuelve una respuesta JSON que contiene la URL de descarga del nuevo archivo, los tamaños original y comprimido, y una suma de verificación para validar. Los parámetros opcionales le permiten afinar el nivel de compresión, preservar hojas específicas o incluir en una lista blanca ciertos objetos incrustados si necesita mantener la fidelidad completa para aplicaciones downstream. SDKs completos están disponibles para Python, Node.js, Java y Go, cada uno exponiendo un método wrapper conciso —`compressSpreadsheet(filePath, options)`— que abstrae totalmente la capa HTTP. La documentación detallada de límites de velocidad y los endpoints de carga masiva le permiten procesar miles de archivos por hora sin sobrecargar su infraestructura, mientras que la lógica de reintentos integrada y el manejo de retroceso exponencial mantienen sus pipelines robustos frente a interrupciones de red transitorias. En resumen, la API Compress ofrece una solución rápida, segura y amigable para desarrolladores que reduce la huella de almacenamiento de las hojas de cálculo, acelera las transferencias de archivos y simplifica los flujos de trabajo de gestión de datos con una única llamada sencilla.

Documentos

Parámetros

AppRequest.CompressionLevel: El nivel de compresión de uno a nueve (1 a 9)
UploadFileRequest.OperationId: Este es un ID de operación
UploadFileRequest.Files: Estos son archivos que necesita subir a nuestros servicios en línea; puede preparar los datos a su manera, pero debe seguir el estándar del elemento input HTML.

Usar el endpoint

Envíe una solicitud que incluya los archivos y el token de acceso API Compress

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
El servicio responderá con una URL de descarga del archivo procesado; en este ejemplo es:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Envíe una solicitud que incluya el nombre del archivo y el nombre de la carpeta a API de descarga

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Recibirá el archivo y podrá usarlo o simplemente reenviarlo al siguiente paso de su flujo de trabajo.