Összehasonlítás

Üdvözöljük a Comparison API hivatalos dokumentációs központjában, egy kifejezetten erre a feladatra tervezett megoldásban, amely a táblázatok verziókezelésének gyakran fárasztó feladatát egy letisztult, fejlesztőközpontú munkafolyamattá alakítja. Akár adat-analitikus vagy, aki negyedéves jelentéseket egyeztet, akár pénzügyi csapat, amely a költségvetés módosításait követi, vagy szoftvermérnök, aki diff képességeket ágyaz be nagyobb adatcsővezetékbe, ez az API úgy lett kialakítva, hogy a jelenlegi helyzetedhez illeszkedjen, és elvegye a találgatást a változások felismeréséről a különféle táblázatformátumok között. Alapvetően a Comparison API egy egyszerű, de erőteljes modell szerint működik: két forrásfájlt adsz meg – legyen az Apple Numbers, CSV/TSV export vagy a mindennapos Excel (.xlsx, .xls) – és a szolgáltatás egyetlen eredményfájlt ad vissza, amely minden hozzáadást, törlést és módosítást kristálytiszta vizuális jelzésekkel emel ki. A tisztaság hangsúlya nem utólagos gondolat; minden különbséget úgy jelölnek meg, hogy az tükrözze a natív táblázat-convenciókat (színezett cellahátterek, megjegyzés buborékok, sor/ oszlop jelölők), így a végfelhasználók kedvenc alkalmazásukban nyithatják meg az eredményt és azonnal megérthetik, mi változott. Az alap diff-en túl az API megőrzi az eredeti formátumot, képleteket és adattípusokat, biztosítva, hogy a kimenet ne csak egyszerű szöveges jelentés legyen, hanem teljes értékű munkafüzet, amely készen áll a további elemzésre vagy terjesztésre. A biztonság és a teljesítmény minden kérésben be van építve: minden fájlátvitel TLS 1.3 felett zajlik, a fájlok izolált konténerekben, szigorú memóriahatárokkal kerülnek feldolgozásra, és az eredmények általában egy másodpercnél gyorsabban visszatérnek 10 MB-ig terjedő fájlok esetén, nagyobb adatkészleteknél pedig darabos streaming segítségével skálázódik. A most olvasott dokumentáció úgy van felépítve, hogy perceken belül elindulhass – az autentikációval kezdve, a kérés felépítésén át a hibakezelés, lapozás és webhook integráció legjobb gyakorlataira végződve. A szöveg során Python, JavaScript, Java és C# kódrészleteket találsz, amelyek azt mutatják, hogyan indíthat egyetlen kódsor egy teljes összehasonlítást, valamint egy sandbox környezetet, ahol valódi fájlokkal kísérletezhetsz anélkül, hogy elhagynád a böngésződet. A útmutató végére alaposan megérted, hogyan ágyazhatod be a megbízható, nagy pontosságú táblázat-összehasonlítást bármilyen munkafolyamatba, csökkentheted a manuális felülvizsgálati időt, és átlátható, auditálható változásnaplókkal felhatalmazhatod az érintetteket – mindezt egy olyan API-val, amely egyszerre biztonságos, gyors és könnyen használható.

Fő Funkciók

A Comparison API egy kiterjedt funkciókészlettel rendelkezik, amely a táblázati adatok különböző platformok közötti egyeztetése során leggyakrabban felmerülő problémákat oldja meg. Először is, az API támogatja a fájlformátumok széles skáláját: Apple Numbers (.numbers), egyszerű szöveges elválasztott fájlok (CSV, TSV), régi Excel (.xls), és modern Excel (.xlsx). Ez megszünteti az előzetes konverziós eszközök szükségességét, lehetővé téve, hogy az eredeti fájlokat közvetlenül a szolgáltatásba töltsd fel. A diff motor cellaszinten működik, értékek, képletek és még a formázási attribútumok, mint betűtípus, cellaszínezés és adatérvényesítési szabályok változását is észleli; minden eltérés egyértelműen kiemelésre kerül a kapott munkafüzetben testreszabható színpalettával, így a nem technikai felhasználók is könnyen értelmezhetik a kimenetet. Nagyobb adattömegek esetén az API inkrementális összehasonlítási módot kínál, amely csak a korábbi alapvonal óta hozzáadott vagy módosított sorokat hasonlítja össze, ezáltal csökkentve a feldolgozási időt és a hálózati sávszélességet. Emellett kérheted a változások strukturált JSON összefoglalóját a vizuális diff fájl mellett, ami lehetővé teszi az olyan downstream automatizálásokat, mint riasztások indítása, dashboardok frissítése vagy a változások verziókezelő rendszerekbe való beillesztése. A biztonsági funkciók közé tartozik az OAuth 2.0 bearer token hitelesítés, a környekhez kötött API kulcsok és az opcionális IP‑whitelisting, míg a nyugalmi állapotban lévő adat AES‑256-tal van titkosítva. A szolgáltatás megfelel a GDPR és a CCPA megfelelőségi szabványoknak, így biztos lehet a személyes vagy pénzügyi adatok kezelésében. Teljesítmény tekintetében az API alacsony késleltetésre van optimalizálva; a horizontális skálázásnak és a memóriabeli diff algoritmusoknak köszönhetően a legtöbb összehasonlítás egy másodpercnél kevesebb idő alatt befejeződik standard méretű munkafüzeteknél, és aszinkron feldolgozást is támogat webhookokkal 50 MB-nál nagyobb fájlok esetén. Végül a fejlesztői élmény kiemelt prioritás: átfogó OpenAPI specifikációk, automatikusan generált SDK-k, részletes hibakódok és valós‑időben frissülő rate‑limit fejlécek, amelyek minimális súrlódással segítik az API integrálását, míg sandbox konzolunk és a kiterjedt mintakönyvtárunk a legjobb gyakorlatú implementációkat mutatja be kötegelt feldolgozáshoz, CI/CD pipeline‑okhoz és szerver nélküli funkciókhoz. Összefoglalva, a Comparison API gyors, biztonságos és fejlesztőbarát táblázat‑diff képességeket nyújt, amelyekkel egyetlen egyszerű hívással észlelheted a változásokat – függetlenül a formátumtól, mérettől vagy a kezelt adatok összetettségétől.

Dokumentumok

Paraméterek

format: Támogatott kimeneti fájlformátum.
UploadFileRequest.OperationId: Ez egy művelet azonosító.
UploadFileRequest.Files: Ezek a fájlok, amelyeket fel kell töltened a webes szolgáltatásunkba; az adatokat saját módon készítheted el, de meg kell felelniük az HTML input fájl szabványának.

Használd a Végpontot

Küldj egy kérés, amely tartalmazza a fájlokat és a hozzáférési tokent 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'
A szolgáltatás egy letöltési URL-t ad vissza a feldolgozott fájlhoz, ebben a példában ez:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Küldj egy kérést, amely tartalmazza a fájl nevét és a mappa nevét a Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Megkapod a fájlt, és felhasználhatod, vagy egyszerűen továbbíthatod a munkafolyamatod következő lépéséhez.