Confronto

Benvenuto nell'hub di documentazione ufficiale per l'API Confronto, una soluzione appositamente progettata che trasforma il compito spesso tedioso del controllo di versione dei fogli di calcolo in un flusso di lavoro semplificato e incentrato sullo sviluppatore. Che tu sia un analista dei dati che riconcilia report trimestrali, un team finanziario che traccia revisioni di budget, o un ingegnere del software che incorpora capacità di diff in una più ampia pipeline di dati, questa API è progettata per incontrarti dove sei e togliere le ipotesi dal rilevare le modifiche su una vasta gamma di formati di foglio di calcolo. Nel suo nucleo, l'API Confronto segue un modello semplice ma potente: fornisci due file di origine — che provengano da Apple Numbers, un'esportazione CSV/TSV, o la suite onnipresente di Excel (.xlsx, .xls) — e il servizio restituisce un unico file risultato che mette in evidenza ogni aggiunta, eliminazione e modifica con chiari indizi visivi. L'enfasi sulla chiarezza non è un ripensamento; ogni differenza è annotata in modo che rifletta le convenzioni native dei fogli di calcolo (sfondi delle celle colorati, bolle di commento e marcatori di riga/colonna) così che gli utenti finali possano aprire il risultato nella loro applicazione preferita e capire immediatamente cosa è cambiato. Oltre al diff di base, l'API preserva anche la formattazione originale, le formule e i tipi di dati, garantendo che il risultato non sia solo un rapporto di testo semplice ma una cartella di lavoro pienamente funzionale pronta per ulteriori analisi o distribuzione. Sicurezza e prestazioni sono integrate in ogni richiesta: tutti i trasferimenti di file avvengono su TLS 1.3, i file sono elaborati in contenitori isolati con rigorosi limiti di memoria, e i risultati sono tipicamente restituiti in meno di un secondo per file fino a 10 MB, scalando con eleganza per dataset più grandi tramite streaming a blocchi. La documentazione che stai leggendo ora è organizzata per farti partire in minuti — iniziando con l'autenticazione, passando per la costruzione della richiesta, e culminando con pattern di best‑practice per la gestione degli errori, la paginazione e l'integrazione dei webhook. Durante tutto il percorso troverai snippet di codice in Python, JavaScript, Java e C#, che illustrano come una singola riga di codice possa attivare un confronto completo, oltre a un ambiente sandbox dove sperimentare con file reali senza lasciare il browser. Al termine di questa guida avrai una solida comprensione di come incorporare un affidabile confronto di fogli di calcolo ad alta fedeltà in qualsiasi flusso di lavoro, ridurre il tempo di revisione manuale e fornire agli stakeholder registri di cambiamento trasparenti e auditabili — il tutto sfruttando un'API tanto sicura e veloce quanto semplice da usare.

Caratteristiche Principali

Le funzionalità dell'API Confronto sono ampie e affrontano i punti dolenti più comuni nella riconciliazione dei dati dei fogli di calcolo su piattaforme diverse. Prima di tutto, l'API supporta un elenco completo di formati di file: Apple Numbers (.numbers), file di testo delimitati (CSV, TSV), Excel legacy (.xls) ed Excel moderno (.xlsx). Ciò elimina la necessità di strumenti di pre‑conversione, permettendoti di inviare i file originali direttamente al servizio. Il motore di diff opera a livello di cella, rilevando cambiamenti nei valori, nelle formule e anche negli attributi di formattazione come stile del carattere, sfumature delle celle e regole di convalida dei dati; ogni variazione è evidenziata chiaramente nella cartella di lavoro risultante con schemi di colore personalizzabili, facilitando l'interpretazione da parte di revisori non tecnici. Per set di dati su larga scala, l'API offre una modalità di confronto incrementale, consentendo di confrontare solo le righe aggiunte o modificate rispetto a una base precedente, riducendo così i tempi di elaborazione e la larghezza di banda. Inoltre, è possibile richiedere un riepilogo JSON strutturato delle modifiche oltre al file di diff visivo, abilitando automazioni downstream come l'attivazione di avvisi, l'aggiornamento di dashboard o l'integrazione delle modifiche nei sistemi di controllo versione. Le funzionalità di sicurezza includono l'autenticazione OAuth 2.0 con token Bearer, chiavi API con ambiti, e whitelist IP opzionale, mentre i dati a riposo sono crittografati con AES‑256. Il servizio rispetta inoltre gli standard di conformità GDPR e CCPA, garantendo tranquillità nella gestione di informazioni personali o finanziarie sensibili. Dal punto di vista delle prestazioni, l'API è progettata per bassa latenza; grazie al ridimensionamento orizzontale e agli algoritmi di diff in‑memoria, la maggior parte dei confronti si completa in meno di un secondo per cartelle di lavoro di dimensioni standard, con supporto per elaborazione asincrona via webhook per file superiori a 50 MB. Infine, l'esperienza dello sviluppatore è una priorità: specifiche OpenAPI complete, SDK auto‑generati, codici di errore dettagliati e header di rate‑limit in tempo reale ti permettono di integrare l'API con minima frizione, mentre la nostra console sandbox e il vasto repository di esempi mostrano implementazioni di best‑practice per elaborazione batch, pipeline CI/CD e funzioni serverless. In breve, l'API Confronto fornisce capacità di diff di fogli di calcolo veloci, sicure e orientate allo sviluppatore, che ti permettono di individuare le modifiche con una singola chiamata semplice — indipendentemente dal formato, dalla dimensione o dalla complessità dei dati che stai gestendo.

Documenti

Parametri

format: Un formato di file di output supportato.
UploadFileRequest.OperationId: Questo è un ID operazione
UploadFileRequest.Files: Questi sono i file che devi caricare sui nostri servizi online, puoi preparare i dati a modo tuo ma devono seguire lo standard dell'input file HTML.

Usa l'Endpoint

Invia una richiesta che includa i file e il token di accesso API di Confronto

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'
Il servizio risponderà con un URL di download per il file elaborato, in questo esempio è:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Invia una richiesta che includa il nome del file e il nome della cartella a API di Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Riceverai il file e potrai usarlo oppure semplicemente inoltrarlo al passo successivo del tuo flusso di lavoro.