Vertailu

Tervetuloa Comparison API:n viralliseen dokumentaatiosivustoon, tarkoituksellisesti rakennettuun ratkaisuun, joka muuttaa usein työlään taulukkolaskentaversioiden hallinnan suoraviivaiseen, kehittäjälähtöiseen työnkulkuun. Olitpa sitten data-analyytikko, joka sovittaa yhteen neljännesvuosikatsaukset, talousryhmä, joka seuraa budjettimuutoksia, tai ohjelmistosuunnittelija, joka upottaa diff-ominaisuuksia osaksi laajempaa dataputkea, tämä API on suunniteltu vastaamaan tarpeitasi ja poistamaan arvaamistarve muutosten havaitsemisessa eri taulukkoformaateissa. Vertailu‑API:n ydinmalli on yksinkertainen mutta voimakas: syötät kaksi lähdetiedostoa – oli ne peräisin Apple Numbersista, CSV/TSV‑viennistä tai laajalle levinneestä Excel‑paketista (.xlsx, .xls) – ja palvelu palauttaa yhden tulostiedoston, jossa jokainen lisäys, poisto ja muutos on korostettu kristallinkirkkailla visuaalisilla merkinnöillä. Selkeyteen panostaminen ei ole jälkikäteen lisättyä; jokainen ero merkataan tavalla, joka jäljittelee alkuperäisten taulukoiden konventioita (värikoodatut solutaustat, kommenttipallot ja rivi-/sarakemerkinnät), jotta loppukäyttäjät voivat avata tuloksen suosikkisovelluksessaan ja heti ymmärtää, mitä on muuttunut. Perus‑diffin lisäksi API säilyttää alkuperäisen muotoilun, kaavat ja tietotyypit, jolloin tulos ei ole pelkkä pelkkä tekstiraportti, vaan täysin toimiva työkirja, valmis jatkoanalyysiin tai jakeluun. Turvallisuus ja suorituskyky sisältyvät jokaisen pyynnön perusalueeseen: kaikki tiedostosiirrot tapahtuvat TLS 1.3:lla, tiedostot käsitellään eristettyinä kontteina tiukoilla muistirajoituksilla, ja tulokset palautetaan tyypillisesti alle sekunnissa enintään 10 MB:n tiedostoille, skaalaten sulavasti suuremmille tietoaineistoille paloittain suoratoiston avulla. Tämä dokumentaatio on järjestetty niin, että pääset nopeasti käyttöön – alkaen todennuksesta, siirtyen pyynnön muodostamiseen ja päätyen parhaiden käytäntöjen malleihin virheenkäsittelyssä, sivutuksessa ja webhook‑integraatiossa. Löydät läpi koko dokumentaation koodikatkelmia Pythonilla, JavaScriptillä, Javalla ja C#:lla, jotka osoittavat, kuinka yksi koodirivi käynnistää koko vertailun, sekä hiekkalaatikkoympäristön, jossa voit testata todellisia tiedostoja suoraan selaimessasi. Oppaan lopussa sinulla on vankka käsitys siitä, miten sulauttaa luotettava, korkean tarkkuuden taulukkovertailu mihin tahansa työnkulkuun, vähentää manuaalista tarkastusaikaa ja antaa sidosryhmille läpinäkyvät, auditointikelpoiset muutospäiväkirjat — kaikki tämän API:n avulla, joka on yhtä turvallinen ja nopea kuin helppokäyttöinen.

Pääominaisuudet

Comparison API:lla on laaja ominaisuuksien valikoima, joka vastaa yleisimpiin haasteisiin, joita kohtaavat taulukkoaineiston yhtenäistämisessä eri alustoilla. Ensinnäkin API tukee kattavaa tiedostomuotojen listaa: Apple Numbers (.numbers), puhtaasti tekstimuotoiset rajatut tiedostot (CSV, TSV), vanhempi Excel (.xls) ja nykyaikainen Excel (.xlsx). Tämä poistaa tarpeen esimuunnostyökaluille, jolloin alkuperäiset tiedostot voidaan syöttää suoraan palveluun. Diff‑moottori toimii solutasolla, tunnistaen muutokset arvoissa, kaavoissa ja jopa muotoiluominaisuuksissa, kuten fonttityyli, solun varjostus ja datan validointisäännöt; jokainen ero korostuu selvästi tulostyökirjassa muokattavilla väriteemoilla, mikä helpottaa ei‑teknisiä tarkistajia tuloksen tulkitsemisessa. Suurten tietoaineistojen osalta API tarjoaa inkrementaalisen vertailutilan, jonka avulla voidaan vertailla vain ne rivit, jotka on lisätty tai muokattu edellisestä peruslinjauksesta, mikä vähentää käsittelyaikaa ja verkko‑kaistaa. Lisäksi voit pyytää rakenteellista JSON‑yhteenvetoa muutoksista visuaalisen diff‑tiedoston lisäksi, mahdollistaen jatkokehityksen, kuten hälytysten käynnistämisen, kojelautojen päivityksen tai muutosten syöttämisen versionhallintajärjestelmiin. Turvallisuusominaisuuksiin kuuluvat OAuth 2.0 -avointunnisteen todennus, rajatut API‑avaimet ja vapaaehtoinen IP‑valkoisen listan käyttö, kun taas levossa oleva data on salattu AES‑256:lla. Palvelu noudattaa myös GDPR‑ ja CCPA‑säädöksiä, mikä tarjoaa luottamusta arkaluontoisten henkilö‑ tai taloustietojen käsittelyyn. Suorituskyvyn osalta API on suunniteltu alhaiseen latenssiin; vaakasuoran skaalaamisen ja muistissa tapahtuvan diff‑algoritmin ansiosta suurin osa vertailuista valmistuu alle sekunnissa tavalliskokoisille työkirjoille, ja yli 50 MB:n tiedostoille on tuki asynkroniselle käsittelylle webhookien kautta. Lopuksi, kehittäjäkokemus on ensisijainen: laaja OpenAPI‑määrittely, automaattisesti generoituja SDK‑ja, yksityiskohtaiset virhekoodit ja reaaliaikaiset rajoitusotsikot mahdollistavat API:n helpon integraation, kun taas hiekkalaatikko‑konsoli ja laaja esimerkkivarasto esittelevät parhaita käytäntöjä eräkäsittelyyn, CI/CD‑putkiin ja serverless‑toimintoihin. Yhteenvetona Comparison API tarjoaa nopeat, turvalliset ja kehittäjäystävälliset taulukko‑diff‑toiminnot, joiden avulla voit havaita muutokset yhdellä yksinkertaisella kutsulla – riippumatta formaatista, koosta tai tiedon monimutkaisuudesta.

Asiakirjat

Parametrit

format: Tuettu lähtöaineiston tiedostomuoto.
UploadFileRequest.OperationId: Tämä on toimenpidetunniste.
UploadFileRequest.Files: Nämä ovat tiedostoja, jotka sinun tulee lähettää verkko‑palveluihimme; voit valmistella datan omalla tavallasi, mutta sen on noudatettava HTML‑syötetiedoston standardia.

Käytä päätepistettä

Lähetä pyyntö, joka sisältää tiedostot ja käyttöoikeustunnuksen Vertailu‑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'
Palvelu vastaa ladattavalla URL‑osoitteella käsiteltyyn tiedostoon, tässä esimerkissä se on:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Lähetä pyyntö, joka sisältää tiedostonimen ja kansion nimen kohteeseen Lataus‑API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Saat tiedoston, ja voit joko käyttää sitä tai yksinkertaisesti siirtää sen työnkulusi seuraavaan vaiheeseen.