Vergelijking
Welkom bij de officiële documentatiehub voor de Comparison API, een speciaal opgebouwde oplossing die de vaak vervelende taak van spreadsheet‑versiebeheer omzet in een gestroomlijnde, ontwikkelaar‑gerichte workflow. Of je nu een data‑analist bent die kwartaalrapporten reconcilieert, een finance‑team dat budgetwijzigingen bijhoudt, of een software‑engineer die diff‑functionaliteit in een grotere datapijplijn integreert, deze API is ontworpen om je daar te ontmoeten waar je staat en het giswerk weg te nemen bij het opsporen van veranderingen in een breed scala aan spreadsheet‑formaten. In de kern volgt de Comparison API een eenvoudig maar krachtig model: je levert twee bronbestanden—ongeacht of ze afkomstig zijn van Apple Numbers, een CSV/TSV‑export, of de alomtegenwoordige Excel‑suite (.xlsx, .xls)—en de service retourneert één resultaatbestand dat elke toevoeging, verwijdering en wijziging duidelijk markeert met kristalheldere visuele aanwijzingen. De nadruk op duidelijkheid is geen bijzaak; elk verschil wordt geannoteerd op een manier die overeenkomt met de native spreadsheet‑conventies (kleurgecodeerde celachtergronden, commentaarballonnen en rij‑/kolommarkers) zodat eindgebruikers het resultaat in hun favoriete applicatie kunnen openen en onmiddellijk begrijpen wat er is verschoven. Naast de basis‑diff behoudt de API ook de oorspronkelijke opmaak, formules en gegevenstypen, waardoor de output niet alleen een platte‑tekst rapport is maar een volledig functionele werkmap klaar voor verdere analyse of distributie. Beveiliging en prestaties zijn ingebouwd in elk verzoek: alle bestandsoverdrachten verlopen via TLS 1.3, bestanden worden verwerkt in geïsoleerde containers met strikte geheugengrenzen, en resultaten worden doorgaans binnen een seconde teruggegeven voor bestanden tot 10 MB, en schalen elegant voor grotere datasets via chunk‑streaming. De documentatie die je nu leest is gestructureerd om je binnen enkele minuten operationeel te maken—beginnend met authenticatie, vervolgens verzoekopbouw, en eindigend met best‑practice patronen voor foutafhandeling, paginering en webhook‑integratie. Gedurende dit alles vind je code‑fragmenten in Python, JavaScript, Java en C#, die laten zien hoe één regel code een volledige vergelijking kan starten, evenals een sandbox‑omgeving waar je met echte bestanden kunt experimenteren zonder je browser te verlaten. Aan het einde van deze gids heb je een grondig begrip van hoe je betrouwbare, hoge‑fideliteit spreadsheet‑vergelijkingen in elke workflow kunt integreren, handmatige review‑tijd kunt verminderen en stakeholders kunt voorzien van transparante, auditbare changelogs— alles terwijl je een API gebruikt die net zo veilig en snel is als hij gemakkelijk te gebruiken is.
Hoofdfuncties
De Comparison API beschikt over een uitgebreide reeks functies die de meest voorkomende pijnpunten aanpakken bij het reconciliëren van spreadsheet‑data over verschillende platforms. Allereerst ondersteunt de API een brede lijst van bestandsformaten: Apple Numbers (.numbers), gewone tekst‑gescheiden bestanden (CSV, TSV), legacy Excel (.xls) en moderne Excel (.xlsx). Dit elimineert de noodzaak voor pre‑conversietools, zodat je de originele bestanden direct naar de service kunt sturen. De diff‑engine werkt op celniveau en detecteert wijzigingen in waarden, formules en zelfs opmaak‑attributen zoals lettertype‑stijl, cel‑schaduwen en gegevensvalidatieregels; elke variant wordt duidelijk gemarkeerd in de resulterende werkmap met aanpasbare kleurenschema's, waardoor niet‑technische reviewers de output gemakkelijk kunnen interpreteren. Voor grote datasets biedt de API een incrementele vergelijkingsmodus, waarmee je alleen de rijen kunt vergelijken die sinds een eerdere basislijn zijn toegevoegd of gewijzigd, wat verwerkingstijd en netwerkbandbreedte vermindert. Bovendien kun je een gestructureerde JSON‑samenvatting van de wijzigingen aanvragen naast het visuele diff‑bestand, waardoor downstream‑automatisering mogelijk wordt, zoals het triggeren van alerts, bijwerken van dashboards of het invoeren van wijzigingen in versiebeheersystemen. Beveiligingsfuncties omvatten OAuth 2.0 bearer‑token authenticatie, scoped API‑sleutels en optionele IP‑whitelisting, terwijl data at rest versleuteld is met AES‑256. De service voldoet ook aan GDPR‑ en CCPA‑compliancestandaarden, wat je vertrouwen geeft bij het verwerken van gevoelige persoonlijke of financiële informatie. Wat prestaties betreft, is de API ontworpen voor lage latency; dankzij horizontale scaling en in‑memory diff‑algoritmen voltooit de meeste vergelijkingen binnen één seconde voor werkboeken van standaardgrootte, met ondersteuning voor asynchrone verwerking via webhooks voor bestanden groter dan 50 MB. Ten slotte staat de ontwikkelaarservaring hoog in het vaandel: uitgebreide OpenAPI‑specificaties, automatisch gegenereerde SDK’s, gedetailleerde foutcodes en realtime rate‑limit‑headers stellen je in staat de API met minimale frictie te integreren, terwijl onze sandbox‑console en uitgebreide voorbeeld‑repository best‑practice‑implementaties laten zien voor batch‑verwerking, CI/CD‑pijplijnen en serverless‑functies. Kortom, de Comparison API levert snelle, veilige en ontwikkelaar‑vriendelijke spreadsheet‑diff‑mogelijkheden die je in staat stellen veranderingen te spotten met één eenvoudige oproep—ongeacht het formaat, de grootte of de complexiteit van de data die je verwerkt.
Documenten
Parameters
- format: Een ondersteund uitvoerbestandsformaat.
- UploadFileRequest.OperationId: Dit is een operationele ID
- UploadFileRequest.Files: Dit zijn bestanden die je moet uploaden naar onze online diensten; je kunt de gegevens op je eigen manier voorbereiden, maar ze moeten voldoen aan de standaard van het HTML‑input‑bestand.
Gebruik het eindpunt
-
Stuur een verzoek dat de bestanden en het toegangstoken bevat 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' -
De service zal reageren met een download‑URL voor het verwerkte bestand; in dit voorbeeld is dit:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Stuur een verzoek dat de bestandsnaam en de mapnaam bevat naar Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Je ontvangt het bestand en je kunt het gebruiken of eenvoudig doorsturen naar de volgende stap in je workflow.
