Compress

Welkom bij de officiële documentatie voor Compress, de lichte maar krachtige API die is ontworpen om spreadsheet‑bestanden tot een fractie van de oorspronkelijke grootte te verkleinen met één intuïtief verzoek. In de data‑gedreven wereld van vandaag wisselen teams voortdurend spreadsheets uit die van eenvoudige lijsten tot complexe financiële modellen variëren, en de enorme hoeveelheid van deze bestanden kan al snel een verborgen kost worden — langzamere uploads, hogere opslagkosten en langere verwerkingstijden voor downstream‑systemen. Compress lost deze pijnpunten op door een cloud‑native service te bieden die de interne structuur van uw spreadsheet intelligent analyseert, onnodige ballast verwijdert en de inhoud opnieuw verpakt in een geoptimaliseerde, compacte vorm zonder afbreuk te doen aan gegevensintegriteit of leesbaarheid. Deze documentatie dient als uw enige bron van waarheid en begeleidt u door alles wat u moet weten om de API effectief te gebruiken, van authenticatie en request‑formattering tot foutafhandeling en best‑practice‑strategieën voor batch‑verwerking. Of u nu een ervaren backend‑engineer bent die datapijplijnen integreert, een front‑end ontwikkelaar die de gebruikerservaring bij het uploaden van bestanden wil verbeteren, of een IT‑manager die de opslagkosten binnen uw organisatie wil verlagen, deze gids biedt duidelijke stapsgewijze instructies, code‑fragmenten in meerdere talen en praktijkvoorbeelden die laten zien hoe u de beste compressieresultaten behaalt voor diverse spreadsheet‑formaten. Door de documentatie heen vindt u speciale secties over beveiligingsoverwegingen — zoals TLS‑versleuteling, ondertekende JWT‑tokens en GDPR‑conforme gegevensverwerking — samen met prestatie‑benchmarks die typische latentie en doorvoersnelheid onder verschillende werklasten laten zien. We bevatten ook een uitgebreide FAQ die veelvoorkomende scenario’s behandelt, een probleemoplossingsmatrix voor snelle diagnose van issues, en links naar community‑forums waar u inzichten kunt delen met andere ontwikkelaars die Compress in productie gebruiken. Aan het einde van deze gids moet u zich zeker voelen in het configureren van uw omgeving, het verzenden van een correct gevormde API‑aanroep en het interpreteren van de respons‑payloads, zodat u compressie naadloos kunt integreren in uw bestaande workflows en direct tastbare besparingen op opslagkosten en netwerkbandbreedte kunt zien. Duik erin, verken de secties die passen bij uw rol, en laat Compress het zware werk van gegevensreductie doen zodat u zich kunt richten op het bouwen van rijkere, responsievere applicaties.

Belangrijkste functies

De kern van de Compress API draait om een rijk functie‑pakket dat spreadsheet‑reductie zowel moeiteloos als betrouwbaar maakt. Allereerst ondersteunt de service een breed scala aan bestands‑typen — waaronder Apple Numbers, platte CSV‑ en TSV‑bestanden, evenals Microsoft Excel’s .xlsx‑ en .xls‑formaten — zodat u praktisch elk spreadsheet dat u tegenkomt kunt verzenden zonder een voorafgaande conversie. Onder de motorkap voert de engine een multi‑fase optimalisatie uit: het normaliseert de interne XML‑ of binaire structuur van het bestand, verwijdert dubbele stijlen, voegt identieke cel‑formaten samen, verwijdert verborgen rijen en kolommen zonder gegevens, en comprimeert ingesloten objecten zoals afbeeldingen, diagrammen en draaitabellen door lossless compressie‑algoritmen toe te passen die zijn afgestemd op elke payload. Bovendien detecteert de API redundante metadata, opmerkingen en versie‑informatie die doorgaans de bestandsgrootte doen toenemen maar zelden functioneel zijn. Al deze bewerkingen gebeuren in realtime en leveren resultaten in milliseconden voor bestanden tot 50 MB, en schalen soepel naar grotere documenten met gecontroleerde throttling en voortgangs‑callbacks. Beveiliging is ingebouwd — elk verzoek wordt over HTTPS verzonden, en de service bewaart nooit een kopie van uw bestand buiten het korte verwerkingsvenster, waardoor wordt voldaan aan strikte privacy‑regelgeving. Vanuit het perspectief van de ontwikkelaar is de API zo friction‑less mogelijk ontworpen: een enkele POST naar `/compress`‑endpoint met het bestand als multipart/form‑data retourneert een JSON‑respons met de download‑URL van het nieuwe bestand, oorspronkelijke en gecomprimeerde grootte, en een checksum voor verificatie. Optionele parameters laten u het compressieniveau verfijnen, specifieke sheets behouden, of bepaalde ingesloten objecten op een whitelist plaatsen als u volledige getrouwheid voor downstream‑applicaties moet behouden. Uitgebreide SDK's zijn beschikbaar voor Python, Node.js, Java en Go, elk met een beknopte wrapper‑methode — `compressSpreadsheet(filePath, options)` — die de HTTP‑laag volledig abstraheert. Gedetailleerde rate‑limit documentatie en bulk‑upload endpoints maken het mogelijk duizenden bestanden per uur te verwerken zonder uw infrastructuur te overbelasten, terwijl ingebouwde retry‑logica en exponentiële back‑off uw pijplijnen robuust houden tegen tijdelijke netwerkproblemen. Kortom, de Compress API levert een snelle, veilige en ontwikkelaar‑vriendelijke oplossing die de opslag‑voetafdruk van spreadsheets verkleint, bestandsoverdrachten versnelt en gegevens‑beheersprocessen vereenvoudigt met één eenvoudige oproep.

Documenten

Parameters

AppRequest.CompressionLevel: Het compressieniveau van één tot negen (1 tot 9)
UploadFileRequest.OperationId: Dit is een operatie‑id
UploadFileRequest.Files: Dit zijn bestanden die u moet uploaden naar onze online services, u kunt de data op uw eigen manier voorbereiden maar deze moet voldoen aan de standaard van de html‑input‑file.

Gebruik de endpoint

Verstuur een request dat de bestanden en het toegangstoken bevat Compress API

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'
De service reageert met een download‑URL voor het verwerkte bestand, in dit voorbeeld is dit:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Verstuur een request dat de bestandsnaam en de mapnaam bevat naar Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
U ontvangt het bestand en kunt het gebruiken of simpelweg doorsturen naar de volgende stap van uw workflow.