Kompresja

Witamy w oficjalnej dokumentacji Compress, lekkiego, a jednocześnie potężnego API zaprojektowanego do zmniejszania plików arkuszy kalkulacyjnych do ułamka ich pierwotnego rozmiaru za pomocą jednego, intuicyjnego żądania. W dzisiejszym świecie napędzanym danymi zespoły nieustannie wymieniają się arkuszami, które zawierają wszystko od prostych list po złożone modele finansowe, a ich ogromna liczba szybko staje się ukrytym kosztem — wolniejsze przesyłanie, wyższe opłaty za przechowywanie i dłuższy czas przetwarzania w systemach downstream. Compress rozwiązuje te problemy, oferując usługę chmurową, która inteligentnie analizuje wewnętrzną strukturę arkusza, usuwa niepotrzebne elementy i ponownie pakuje zawartość w zoptymalizowaną, kompaktową formę, nie poświęcając integralności danych ani czytelności. Ta strona dokumentacji jest Twoim jedynym źródłem prawdy, prowadząc Cię przez wszystko, co trzeba wiedzieć, aby efektywnie korzystać z API, od uwierzytelniania i formatowania żądań po obsługę błędów i najlepsze praktyki przetwarzania wsadowego. Niezależnie od tego, czy jesteś doświadczonym inżynierem backendu integrującym pipeline’y danych, deweloperem front‑end szukającym poprawy doświadczenia użytkownika przy przesyłaniu plików, czy menedżerem IT odpowiedzialnym za redukcję kosztów przechowywania w organizacji, przewodnik dostarczy jasnych, krok po kroku instrukcji, fragmentów kodu w wielu językach oraz rzeczywistych przykładów pokazujących, jak uzyskać najlepsze wyniki kompresji dla różnorodnych formatów arkuszy. W dokumentacji znajdziesz dedykowane sekcje dotyczące kwestii bezpieczeństwa — takich jak szyfrowanie TLS, podpisane tokeny JWT oraz zgodność z RODO — oraz benchmarki wydajności pokazujące typowe opóźnienia i przepustowość przy różnych obciążeniach. Dołączamy także obszerną sekcję FAQ obejmującą typowe scenariusze, matrycę rozwiązywania problemów dla szybkiej diagnostyki oraz linki do forów społecznościowych, gdzie możesz dzielić się wnioskami z innymi programistami korzystającymi z Compress w produkcji. Po zakończeniu tego przewodnika będziesz pewny konfiguracji środowisk, wysyłania prawidłowego wywołania API i interpretacji zwracanych danych, co pozwoli Ci bezproblemowo wbudować kompresję w istniejące procesy i od razu zobaczyć wymierne oszczędności na kosztach przechowywania i przepustowości sieci. Zanurz się, eksploruj sekcje odpowiadające Twojej roli i pozwól Compress zająć się ciężkim ciężarem redukcji danych, abyś mógł skupić się na tworzeniu bogatszych, bardziej responsywnych aplikacji.

Główne funkcje

Rdzeń API Compress opiera się na bogatym zestawie funkcji, które sprawiają, że redukcja arkuszy kalkulacyjnych jest zarówno prosta, jak i niezawodna. Przede wszystkim usługa obsługuje szerokie spektrum typów plików — w tym Apple Numbers, zwykłe pliki CSV i TSV oraz formaty Microsoft Excel .xlsx i .xls — dzięki czemu możesz wysłać praktycznie każdy napotkany arkusz bez konieczności wstępnej konwersji. W tle silnik wykonuje wieloetapową optymalizację: normalizuje wewnętrzną strukturę XML lub binarną pliku, eliminuje zduplikowane style, scala identyczne formaty komórek, usuwa ukryte wiersze i kolumny bez danych oraz kompresuje osadzone obiekty, takie jak obrazy, wykresy i tabele przestawne, stosując bezstratne algorytmy kompresji dopasowane do każdego rodzaju treści. Dodatkowo API wykrywa i usuwa zbędne metadane, komentarze oraz informacje wersjonowania, które zazwyczaj zwiększają rozmiar pliku, ale rzadko są potrzebne. Wszystkie te operacje odbywają się w czasie rzeczywistym, dostarczając wyniki w milisekundach dla plików do 50 MB i skalując się płynnie do większych dokumentów przy stosowaniu łagodnego ograniczania i wywołań zwrotnych postępu. Bezpieczeństwo jest wbudowane — każde żądanie jest przesyłane przez HTTPS, a usługa nie przechowuje kopii Twojego pliku poza krótkim oknem przetwarzania, zapewniając zgodność z rygorystycznymi przepisami dotyczącymi prywatności. Z perspektywy programisty API zaprojektowano tak, aby było jak najbardziej bezproblemowe: pojedyncze żądanie POST na endpoint `/compress` z plikiem dołączonym jako multipart/form‑data zwraca odpowiedź JSON zawierającą URL do pobrania nowego pliku, oryginalny i skompresowany rozmiar oraz sumę kontrolną do weryfikacji. Opcjonalne parametry pozwalają precyzyjnie dostosować poziom kompresji, zachować wybrane arkusze lub dodać do białej listy określone obiekty, jeśli potrzebujesz pełnej wierności dla aplikacji downstream. Dostępne są kompleksowe SDK dla Pythona, Node.js, Javy i Go, każde udostępnia krótką metodę wrapper — `compressSpreadsheet(filePath, options)` — która abstrahuje warstwę HTTP. Szczegółowa dokumentacja limitów szybkości oraz endpointy masowego przesyłania umożliwiają przetwarzanie tysięcy plików na godzinę bez przeciążania infrastruktury, a wbudowana logika ponownych prób i eksponencjalny back‑off utrzymują pipeline’y odporne na przejściowe problemy sieciowe. Krótko mówiąc, API Compress dostarcza szybkiego, bezpiecznego i przyjaznego dla deweloperów rozwiązania, które zmniejsza rozmiar przechowywanych arkuszy, przyspiesza ich transfer i upraszcza procesy zarządzania danymi jednym prostym wywołaniem.

Dokumenty

Parametry

AppRequest.CompressionLevel: Poziom kompresji od jednego do dziewięciu (1‑9)
UploadFileRequest.OperationId: To jest identyfikator operacji
UploadFileRequest.Files: To są pliki, które musisz przesłać do naszych usług online; możesz przygotować dane w dowolny sposób, ale muszą one spełniać standard pola input typu file w HTML.

Użyj punktu końcowego

Wyślij żądanie zawierające pliki i token dostępu 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'
Usługa zwróci URL do pobrania przetworzonego pliku, w tym przykładzie jest to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Wyślij żądanie zawierające nazwę pliku i nazwę folderu do API pobierania

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Otrzymasz plik i możesz go użyć lub po prostu przekazać do następnego kroku swojego przepływu pracy.