Porovnanie

Vitajte v oficiálnom centre dokumentácie pre Comparison API, riešení špeciálne navrhnutých na transformáciu často únavnej úlohy správy verzií tabuľkových dokumentov do optimalizovaného, vývojárom orientovaného pracovného toku. Či už ste analytik dát, ktorý zosúlaďuje štvrťročné správy, finančný tím sledujúci revízie rozpočtu, alebo softvérový inžinier integrujúci funkcie diff do väčšieho dátového pipeline, toto API je navrhnuté tak, aby vám vyhovovalo tam, kde ste, a odstránilo hádanie pri hľadaní zmien v širokej škále formátov tabuľkových dokumentov. V jadre Comparison API sa nachádza jednoduchý, no výkonný model: poskytujete dva zdrojové súbory – či už pochádzajú z Apple Numbers, CSV/TSV exportu alebo rozšírenej sady Excel (.xlsx, .xls) – a služba vráti jeden výsledný súbor, ktorý zvýrazní každé pridanie, odstránenie a úpravu pomocou jasných vizuálnych indikátorov. Dôraz na prehľadnosť nie je dodatočný; každý rozdiel je anotovaný spôsobom, ktorý odráža natívne konvencie tabuľkových dokumentov (farebne kódované pozadia buniek, bubliny komentárov a značky riadkov/ stĺpcov), takže koncový používateľ môže otvoriť výsledok vo svojej preferovanej aplikácii a okamžite pochopiť, čo sa zmenilo. Okrem základného diffu API tiež zachováva pôvodné formátovanie, vzorce a dátové typy, čím zabezpečuje, že výstup nie je len čistý textový report, ale plnohodnotná pracovná kniha pripravená na ďalšiu analýzu alebo distribúciu. Bezpečnosť a výkon sú zabudované do každej požiadavky: všetky prenosy súborov prebiehajú cez TLS 1.3, súbory sa spracúvajú v izolovaných kontajneroch s prísnymi limitmi pamäte a výsledky sa zvyčajne vracajú za menej ako sekundu pre súbory do 10 MB, pričom sa plynule škálujú pre väčšie dátové sady pomocou chunkovaného streamovania. Dokumentácia, ktorú práve čítate, je usporiadaná tak, aby ste boli spustený v priebehu niekoľkých minút – od overovania, cez konštrukciu požiadaviek, až po osvedčené postupy pre spracovanie chýb, stránkovanie a integráciu webhookov. Počas celej dokumentácie nájdete ukážky kódu v Pythone, JavaScripte, Jave a C#, ktoré ukazujú, ako jediný riadok kódu môže spustiť kompletné porovnanie, ako aj sandboxové prostredie, kde môžete experimentovať so skutočnými súbormi priamo v prehliadači. Na konci tohto sprievodcu budete mať pevné pochopenie, ako vložiť spoľahlivé, vysokokvalitné porovnanie tabuľkových dokumentov do akéhokoľvek pracovného toku, znížiť čas manuálnej kontroly a umožniť zúčastneným stranám transparentné, auditovateľné záznamy zmien – a to všetko s využitím API, ktoré je rovnako bezpečné a rýchle, ako je jednoduché na použitie.

Hlavné funkcie

Comparison API ponúka rozsiahlu sadu funkcií, ktoré riešia najčastejšie problémy pri zosúladzovaní dát z tabuľkových dokumentov naprieč rôznymi platformami. Predovšetkým API podporuje komplexný zoznam formátov súborov: Apple Numbers (.numbers), textové súbory s oddeľovačmi (CSV, TSV), starší Excel (.xls) a moderný Excel (.xlsx). Tým sa eliminuje potreba predkonverzných nástrojov a umožňuje priamo nahrávať originálne súbory do služby. Rozdielový engine pracuje na úrovni buniek, deteguje zmeny v hodnotách, vzorcoch a dokonca aj vo formátovacích atribútoch ako štýl písma, tieňovanie buniek a pravidlá overovania dát; každá odchýlka je jasne zvýraznená v výslednej pracovnej knihe pomocou prispôsobiteľných farebných schém, čo uľahčuje interpretáciu výstupu pre netechnických recenzentov. Pre veľké dátové sady API ponúka inkrementálny režim porovnania, ktorý umožňuje porovnať iba riadky pridané alebo upravené od predchádzajúcej základne, čím sa znižuje čas spracovania a šírka pásma. Okrem toho môžete požadovať štruktúrovaný JSON súhrn zmien okrem vizuálneho diff súboru, čo umožňuje downstream automatizáciu ako spúšťanie upozornení, aktualizáciu dashboardov alebo zasielanie zmien do systémov správy verzií. Bezpečnostné funkcie zahŕňajú autentifikáciu OAuth 2.0 pomocou používateľského tokenu, kľúče API s obmedzeným rozsahom a voliteľné whitelistovanie IP adries, pričom údaje v pokoji sú šifrované pomocou AES‑256. Služba tiež spĺňa štandardy GDPR a CCPA, čím vám dáva istotu pri práci s citlivými osobnými alebo finančnými informáciami. Pokiaľ ide o výkon, API je navrhnuté pre nízku latenciu; vďaka horizontálnemu škálovaniu a in‑memory diff algoritmom prebehne väčšina porovnaní za menej ako sekundu pre bežné veľkosti pracovných kníh, s podporou asynchrónneho spracovania cez webhooky pre súbory presahujúce 50 MB. Nakoniec je skúsenosť vývojárov prioritou: komplexné špecifikácie OpenAPI, automaticky generované SDK, podrobné chybové kódy a hlavičky na limit rýchlosti v reálnom čase vám umožňujú integrovať API s minimálnymi prekážkami, zatiaľ čo naše sandboxové rozhranie a rozsiahle ukážkové repozitáre prezentujú osvedčené implementácie pre dávkové spracovanie, CI/CD pipeline a serverless funkcie. Skrátka, Comparison API poskytuje rýchle, bezpečné a vývojárovi priateľské možnosti diffu tabuľkových dokumentov, ktoré vám umožnia odhaliť zmeny jediným jednoduchým volaním – bez ohľadu na formát, veľkosť alebo zložitosť dát, s ktorými pracujete.

Dokumenty

Parametre

format: Podporovaný výstupný formát súboru.
UploadFileRequest.OperationId: Toto je ID operácie
UploadFileRequest.Files: Sú to súbory, ktoré musíte nahrať do našich online služieb; dáta môžete pripraviť vlastným spôsobom, ale musia spĺňať štandard HTML vstupného súboru.

Použiť koncový bod

Odoslať požiadavku, ktorá obsahuje súbory a prístupový token Porovnávacie 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 odpovie URL na stiahnutie spracovaného súboru, v tomto príklade je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Odoslať požiadavku, ktorá obsahuje názov súboru a názov priečinka do API na stiahnutie

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte súbor a môžete ho buď použiť, alebo jednoducho odovzdať do ďalšieho kroku vášho pracovného toku.