Porovnání

Vítejte v oficiálním centru dokumentace pro Comparison API, řešení navržené speciálně pro transformaci často únavného úkolu správy verzí tabulek do zjednodušeného, vývojářsky orientovaného workflow. Ať už jste analytik dat, který slaďuje čtvrtletní zprávy, finanční tým sledující revize rozpočtu, nebo softwarový inženýr implementující diff funkce do většího datového potrubí, toto API je navrženo tak, aby vám vyhovělo tam, kde jste, a odstranilo hádání při hledání změn napříč širokou škálou formátů tabulek. V jádru Comparison API stojí jednoduchý, ale výkonný model: poskytujete dva zdrojové soubory – ať už pocházejí z Apple Numbers, CSV/TSV exportu, nebo z běžné sady Excel (.xlsx, .xls) – a služba vrátí jeden výstupní soubor, který zvýrazní každé přidání, smazání a úpravu pomocí jasných vizuálních indikátorů. Důraz na přehlednost není jen přídatná funkce; každá rozdílnost je anotována způsobem, který odráží nativní konvence tabulek (barevně kódované pozadí buněk, bubliny komentářů a značky řádků/sloupců), takže koncoví uživatelé mohou výsledek otevřít ve své preferované aplikaci a okamžitě pochopit, co se změnilo. Kromě základního diffu API také zachovává původní formátování, vzorce a datové typy, což zajišťuje, že výstup není jen prostý textový report, ale plně funkční sešit připravený k dalšímu analyzování nebo distribuci. Bezpečnost a výkon jsou zakomponovány do každého požadavku: veškerý přenos souborů probíhá přes TLS 1.3, soubory jsou zpracovávány v izolovaných kontejnerech s přísnými limity paměti a výsledky jsou obvykle vráceny za méně než sekundu pro soubory až do 10 MB, přičemž se elegantně škálují pro větší datové sady pomocí chunkovaného streamování. Dokumentace, kterou nyní čtete, je uspořádána tak, aby vás během minut uvedla do chodu – začíná autentizací, pokračuje konstrukcí požadavků a končí osvědčenými postupy pro zpracování chyb, stránkování a integraci webhooků. Po celou dobu najdete ukázky kódu v Pythonu, JavaScriptu, Javě a C#, které ukazují, jak může jediný řádek kódu spustit kompletní porovnání, a také sandboxové prostředí, kde můžete experimentovat s reálnými soubory přímo v prohlížeči. Na konci tohoto průvodce budete mít pevné pochopení, jak vložit spolehlivé, vysoce přesné porovnání tabulek do jakéhokoli workflow, snížit čas manuálního přezkoumání a poskytnout zúčastněným stranám transparentní, auditovatelné záznamy změn – a to vše při využití API, které je tak bezpečné a rychlé, jak je snadné jej použít.

Hlavní funkce

Comparison API nabízí rozsáhlou sadu funkcí, které řeší nejčastější problémy při sladění dat z tabulek napříč různými platformami. Především API podporuje širokou škálu formátů souborů: Apple Numbers (.numbers), textové soubory s oddělovači (CSV, TSV), starší Excel (.xls) i moderní Excel (.xlsx). To odstraňuje potřebu předchozích konverzních nástrojů a umožňuje nahrát původní soubory přímo do služby. Diff engine pracuje na úrovni buněk a detekuje změny hodnot, vzorců a dokonce i formátovacích atributů, jako je styl písma, stínování buněk a pravidla validace dat; každá odchylka je jasně zvýrazněna v výsledném sešitu pomocí přizpůsobitelných barevných schémat, což usnadňuje ne‑technickým reviewerům interpretaci výstupu. Pro velké datové sady API nabízí inkrementální režim porovnání, který porovnává jen řádky přidané nebo upravené od předchozí základny, čímž snižuje dobu zpracování a šířku pásma. Dále můžete požádat o strukturovaný JSON souhrn změn vedle vizuálního diff souboru, což umožňuje automatizaci jako spouštění upozornění, aktualizaci dashboardů nebo integraci změn do systémů řízení verzí. Bezpečnostní funkce zahrnují OAuth 2.0 tokenovou autentizaci, scoped API klíče a volitelné IP whitelistování, zatímco data v klidu jsou šifrována pomocí AES‑256. Služba také splňuje standardy GDPR a CCPA, což vám dává jistotu při práci s citlivými osobními či finančními informacemi. Co se týče výkonu, API je navrženo pro nízkou latenci; díky horizontálnímu škálování a in‑memory diff algoritmům většina porovnání končí za méně než sekundu u standardních sešitů, s podporou asynchronního zpracování přes webhooky pro soubory nad 50 MB. Nakonec je zkušenost vývojářů prioritou: komplexní OpenAPI specifikace, automaticky generované SDK, podrobné kódy chyb a hlavičky s limity v reálném čase vám umožní integrovat API s minimálním úsilím, zatímco náš sandbox a rozsáhlé ukázkové repozitáře představují osvědčené implementace pro dávkové zpracování, CI/CD pipeline a serverless funkce. Stručně řečeno, Comparison API poskytuje rychlé, bezpečné a vývojářsky přívětivé diffování tabulek, které vám umožní odhalit změny jedním jednoduchým voláním – bez ohledu na formát, velikost nebo složitost dat, které zpracováváte.

Dokumenty

Parametry

format: Podporovaný výstupní formát souboru.
UploadFileRequest.OperationId: Toto je ID operace
UploadFileRequest.Files: Jedná se o soubory, které musíte nahrát do našich online služeb; data můžete připravit jakkoli, ale musí odpovídat standardu HTML vstupního souboru.

Použít koncový bod

Odešlete požadavek, který obsahuje soubory a přístupový token Comparison API

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'
Služba odpoví URL pro stažení zpracovaného souboru, v tomto příkladu je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Odešlete požadavek, který obsahuje název souboru a název složky do Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte soubor a můžete jej buď použít, nebo jednoduše předat do dalšího kroku vašeho workflow.