Compress

Benvenuti nella documentazione ufficiale di Compress, l'API leggera ma potente progettata per ridurre i file di fogli di calcolo a una frazione delle loro dimensioni originali con una singola richiesta intuitiva. Nel mondo odierno guidato dai dati, i team scambiano costantemente fogli di calcolo che contengono da semplici elenchi a complessi modelli finanziari, e il volume di questi file può rapidamente diventare un costo nascosto: caricamenti più lenti, costi di archiviazione aumentati e tempi di elaborazione più lunghi per i sistemi a valle. Compress affronta questi problemi offrendo un servizio cloud‑native che analizza intelligentemente la struttura interna del tuo foglio di calcolo, elimina i dati superflui e ricompone il contenuto in una forma ottimizzata e compatta senza sacrificare l'integrità o la leggibilità dei dati. Questa pagina di documentazione è la tua singola fonte di verità, guidandoti attraverso tutto ciò che devi sapere per utilizzare l'API in modo efficace, dall'autenticazione e formattazione della richiesta alla gestione degli errori e alle migliori pratiche per l'elaborazione batch. Che tu sia un ingegnere backend esperto che integra pipeline di dati, uno sviluppatore front‑end che vuole migliorare l'esperienza utente durante il caricamento dei file, o un responsabile IT incaricato di ridurre l'overhead di archiviazione nella tua organizzazione, questa guida fornirà istruzioni chiare passo‑passo, snippet di codice in più linguaggi e esempi concreti che mostrano come ottenere i migliori risultati di compressione per una vasta gamma di formati di fogli di calcolo. All'interno della documentazione troverai sezioni dedicate alle considerazioni di sicurezza — come la crittografia TLS, i token JWT firmati e la gestione dei dati conforme al GDPR — insieme a benchmark di performance che dimostrano la latenza e il throughput tipici sotto diversi carichi di lavoro. Include inoltre una FAQ estesa che copre scenari comuni, una matrice di troubleshooting per una diagnosi rapida dei problemi e link ai forum della community dove potrai condividere insight con altri sviluppatori che utilizzano Compress in produzione. Alla fine di questa guida dovresti sentirti sicuro nella configurazione degli ambienti, nell'invio di una chiamata API correttamente formattata e nell'interpretazione dei payload di risposta, così da poter integrare senza sforzo la compressione nei tuoi flussi di lavoro esistenti e iniziare a risparmiare immediatamente sui costi di archiviazione e sulla larghezza di banda di rete. Immergiti, esplora le sezioni più rilevanti per il tuo ruolo e lascia che Compress si occupi del lavoro pesante di riduzione dei dati, così potrai concentrarti sulla creazione di applicazioni più ricche e reattive.

Caratteristiche Principali

Il nucleo dell'API Compress ruota attorno a un ricco insieme di funzionalità che rendono la riduzione dei fogli di calcolo semplice e affidabile. Prima di tutto, il servizio supporta un ampio spettro di tipi di file — inclusi Apple Numbers, file CSV e TSV semplici, oltre ai formati .xlsx e .xls di Microsoft Excel — così puoi inviare praticamente qualsiasi foglio di calcolo senza dover eseguire una fase di pre‑conversione. Nel motore interno, avviene un'ottimizzazione a più fasi: normalizza la struttura XML o binaria del file, elimina gli stili duplicati, unisce i formati cella identici, rimuove righe e colonne nascoste prive di dati e comprime gli oggetti incorporati come immagini, grafici e tabelle pivot applicando algoritmi di compressione senza perdita su misura per ciascun payload. Inoltre, l'API rileva e rimuove metadati ridondanti, commenti e informazioni di versionamento che tipicamente gonfiano le dimensioni del file ma raramente hanno uno scopo funzionale. Tutte queste operazioni avvengono in tempo reale, fornendo risultati in millisecondi per file fino a 50 MB e scalando in modo elegante a documenti più grandi con throttling graduale e callback di progresso. La sicurezza è integrata — ogni richiesta è trasferita via HTTPS e il servizio non conserva una copia del tuo file oltre la breve finestra di elaborazione, garantendo la conformità a rigorose normative sulla privacy. Dal punto di vista dello sviluppatore, l'API è progettata per essere il più indolore possibile: un singolo POST all'endpoint `/compress` con il file allegato come multipart/form‑data restituisce una risposta JSON contenente l'URL di download del nuovo file, le dimensioni originali e compresse, e un checksum per la verifica. Parametri opzionali consentono di regolare il livello di compressione, preservare fogli specifici o inserire nella whitelist determinati oggetti incorporati se è necessario mantenere la piena fedeltà per le applicazioni a valle. SDK completi sono disponibili per Python, Node.js, Java e Go, ciascuno esponendo un metodo wrapper conciso — `compressSpreadsheet(filePath, options)` — che astrae completamente il livello HTTP. Documentazione dettagliata sui limiti di velocità e endpoint per caricamenti massivi ti permettono di processare migliaia di file all'ora senza sovraccaricare l'infrastruttura, mentre la logica di retry integrata e la gestione dell'esponenziale back‑off mantengono i tuoi pipeline robusti contro piccoli problemi di rete. In sintesi, l'API Compress offre una soluzione veloce, sicura e orientata allo sviluppatore che riduce l'ingombro di archiviazione dei fogli di calcolo, accelera i trasferimenti di file e semplifica i flussi di gestione dei dati con una singola chiamata semplice.

Documenti

Parametri

AppRequest.CompressionLevel: Il livello di compressione da uno a nove (1‑9)
UploadFileRequest.OperationId: Questo è un ID operazione
UploadFileRequest.Files: Questi sono i file da caricare sul nostro servizio online; puoi preparare i dati come preferisci, ma devono rispettare lo standard dell'elemento input file HTML.

Utilizza l'Endpoint

Invia una richiesta che includa i file e il token di accesso 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'
Il servizio risponderà con un URL di download per il file elaborato; in questo esempio è:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Invia una richiesta che includa il nome del file e il nome della cartella per API Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Riceverai il file e potrai usarlo oppure inoltrarlo al passaggio successivo del tuo workflow.