Porównanie

Zapraszamy do oficjalnego centrum dokumentacji API Porównania, dedykowanego rozwiązania, które przekształca często żmudne zadanie kontroli wersji arkuszy kalkulacyjnych w usprawniony, skierowany do programistów przepływ pracy. Niezależnie od tego, czy jesteś analitykiem danych łączącym kwartalne raporty, zespołem finansowym śledzącym korekty budżetu, czy inżynierem oprogramowania wbudowującym możliwości diff do większego potoku danych, to API zostało zaprojektowane, aby spotkać Cię tam, gdzie jesteś i usunąć zgadywanie przy wykrywaniu zmian w szerokim zestawie formatów arkuszy. W swojej istocie API Porównania opiera się na prostym, a jednocześnie potężnym modelu: dostarczasz dwa pliki źródłowe — niezależnie od tego, czy pochodzą z Apple Numbers, eksportu CSV/TSV czy powszechnego zestawu Excel (.xlsx, .xls) — a usługa zwraca pojedynczy plik wynikowy, który podświetla każde dodanie, usunięcie i modyfikację przy użyciu wyraźnych wskazówek wizualnych. Nacisk na klarowność nie jest dopiero po fakcie; każda różnica jest oznaczona w sposób odzwierciedlający natywne konwencje arkuszy (tła komórek z kodowanymi kolorami, dymki komentarzy oraz znaczniki wierszy/kolumn), tak aby użytkownicy końcowi mogli otworzyć wynik w preferowanej aplikacji i od razu zrozumieć, co się zmieniło. Poza podstawowym diffem API zachowuje pierwotne formatowanie, formuły i typy danych, zapewniając, że wynik nie jest jedynie raportem tekstowym, lecz w pełni funkcjonalnym skoroszytem gotowym do dalszej analizy lub dystrybucji. Bezpieczeństwo i wydajność są wbudowane w każde żądanie: wszystkie transfery plików odbywają się przy użyciu TLS 1.3, pliki przetwarzane są w odizolowanych kontenerach z surowymi limitami pamięci, a wyniki zazwyczaj zwracane są w mniej niż sekundę dla plików do 10 MB, skalując się płynnie dla większych zestawów danych dzięki strumieniowaniu w partiach. Dokumentacja, którą teraz czytasz, jest zorganizowana tak, abyś mógł rozpocząć pracę w ciągu kilku minut — od uwierzytelniania, przez budowanie żądań, po najważniejsze wzorce obsługi błędów, paginacji i integracji webhooków. W całym tekście znajdziesz fragmenty kodu w Python, JavaScript, Java i C#, ilustrujące, jak pojedyncza linia kodu może uruchomić pełne porównanie, a także środowisko sandbox, w którym możesz eksperymentować z prawdziwymi plikami bez opuszczania przeglądarki. Po zakończeniu tego przewodnika będziesz posiadać solidną wiedzę, jak wbudować niezawodne, wysokiej jakości porównanie arkuszy kalkulacyjnych w dowolny przepływ pracy, skrócić czas ręcznej weryfikacji i umożliwić interesariuszom transparentne, audytowalne logi zmian — wszystko to przy użyciu API, które jest tak bezpieczne i szybkie, jak łatwe w użyciu.

Główne funkcje

API Porównania może pochwalić się rozbudowanym zestawem funkcji, które rozwiązują najczęstsze problemy napotykane przy uzgadnianiu danych arkuszy kalkulacyjnych na różnych platformach. Przede wszystkim API obsługuje szeroką listę formatów plików: Apple Numbers (.numbers), pliki tekstowe z separatorami (CSV, TSV), starsze wersje Excel (.xls) oraz nowoczesny Excel (.xlsx). Dzięki temu nie ma potrzeby stosowania narzędzi do wstępnej konwersji, a oryginalne pliki mogą być bezpośrednio przekazywane do usługi. Silnik diff działa na poziomie komórek, wykrywając zmiany wartości, formuł oraz nawet atrybutów formatowania, takich jak styl czcionki, cieniowanie komórek czy reguły walidacji danych; każda różnica jest wyraźnie podświetlona w powstałym skoroszycie przy użyciu konfigurowalnych schematów kolorów, co ułatwia interpretację wyników osobom nietechnicznym. Dla dużych zestawów danych API oferuje tryb porównania przyrostowego, pozwalający porównać tylko wiersze dodane lub zmodyfikowane od poprzedniej wersji, co skraca czas przetwarzania i zużycie przepustowości. Dodatkowo można żądać strukturalnego podsumowania zmian w formacie JSON oprócz wizualnego pliku diff, co umożliwia automatyzację downstream, taką jak wyzwalanie alertów, aktualizowanie pulpitów nawigacyjnych czy przesyłanie zmian do systemów kontroli wersji. Funkcje bezpieczeństwa obejmują uwierzytelnianie tokenem OAuth 2.0, klucze API o określonym zakresie i opcjonalne białe listy IP, a dane w spoczynku są szyfrowane metodą AES‑256. Usługa jest również zgodna z regulacjami GDPR i CCPA, co daje pewność przy przetwarzaniu wrażliwych danych osobowych lub finansowych. Pod względem wydajności API zostało zaprojektowane pod kątem niskiej latencji; dzięki skalowaniu poziomemu i algorytmom diff w pamięci, większość porównań zakończa się w mniej niż jedną sekundę dla standardowych skoroszytów, a dla plików powyżej 50 MB dostępne jest przetwarzanie asynchroniczne przy użyciu webhooków. Na koniec, doświadczenie programistów jest priorytetem: kompleksowe specyfikacje OpenAPI, automatycznie generowane SDK, szczegółowe kody błędów oraz nagłówki limitów szybkości w czasie rzeczywistym umożliwiają łatwą integrację API, a nasza konsola sandbox i obszerne repozytorium przykładów prezentują najlepsze praktyki implementacji przetwarzania wsadowego, pipeline'ów CI/CD oraz funkcji serverless. Krótko mówiąc, API Porównania dostarcza szybkie, bezpieczne i przyjazne dla deweloperów możliwości diffowania arkuszy kalkulacyjnych, pozwalając wykrywać zmiany jednym prostym wywołaniem — niezależnie od formatu, rozmiaru czy złożoności danych, które obsługujesz.

Dokumenty

Parametry

format: Obsługiwany format pliku wyjściowego.
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 wejścia pliku HTML.

Użyj punktu końcowego

Wyślij żądanie zawierające pliki i token dostępu API Porównania

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
Usługa odpowie 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 kolejnego kroku w swoim przepływie pracy.