Σύγκριση

Καλώς ήρθατε στο επίσημο κέντρο τεκμηρίωσης για το Comparison API, μια εξειδικευμένη λύση που μετατρέπει το συχνά μονότονο έργο του ελέγχου εκδόσεων υπολογιστικών φύλλων σε μια απλοποιημένη, προσανατολισμένη στους προγραμματιστές ροή εργασίας. Είτε είστε αναλυτής δεδομένων που συμφιλιώνει τριμηνιαίες αναφορές, είτε μέλος ομάδας οικονομικών που παρακολουθεί τροποποιήσεις προϋπολογισμού, είτε μηχανικός λογισμικού που ενσωματώνει δυνατότητες diff σε μεγαλύτερο pipeline δεδομένων, αυτό το API έχει σχεδιαστεί να σας εξυπηρετήσει όπου βρίσκεστε και να αφαιρέσει τις αμφιβολίες στην ανίχνευση αλλαγών σε μια πληθώρα μορφών υπολογιστικών φύλλων. Στην ουσία, το Comparison API ακολουθεί ένα απλό αλλά ισχυρό μοντέλο: παρέχετε δύο αρχεία προέλευσης — είτε προέρχονται από Apple Numbers, εξαγωγή CSV/TSV, είτε από το ευρέως διαδεδομένο Excel (.xlsx, .xls) — και η υπηρεσία επιστρέφει ένα ενιαίο αρχείο αποτελέσματος που επισημαίνει κάθε προσθήκη, διαγραφή και τροποποίηση με κρυστάλλινα οπτικά σήματα. Η έμφαση στην καθαρότητα δεν είναι μετάβαση· κάθε διαφορά σημειώνεται με τρόπο που αντικατοπτρίζει τις εγγενείς συμβάσεις των υπολογιστικών φύλλων (χρωματισμένα φόντα κελιών, φούσκες σχολίων και δείκτες γραμμής/στήλης) ώστε οι τελικοί χρήστες να μπορούν να ανοίξουν το αποτέλεσμα στην προτιμώμενη εφαρμογή τους και άμεσα να καταλάβουν τι έχει αλλάξει. Πέρα από το βασικό diff, το API διατηρεί επίσης την αρχική μορφοποίηση, τους τύπους και τους τύπους δεδομένων, διασφαλίζοντας ότι η έξοδος δεν είναι απλώς αναφορά απλού κειμένου, αλλά ένα πλήρως λειτουργικό βιβλίο εργασίας έτοιμο για περαιτέρω ανάλυση ή διανομή. Η ασφάλεια και η απόδοση ενσωματώνονται σε κάθε αίτημα: όλες οι μεταφορές αρχείων γίνονται μέσω TLS 1.3, τα αρχεία επεξεργάζονται σε απομονωμένα containers με αυστηρούς περιορισμούς μνήμης, και τα αποτελέσματα επιστρέφονται συνήθως σε λιγότερο από ένα δευτερόλεπτο για αρχεία έως 10 MB, κλιμακώνοντας ομαλά για μεγαλύτερα σύνολα δεδομένων μέσω ροής σε κομμάτια. Η τεκμηρίωση που διαβάζετε τώρα είναι οργανωμένη ώστε να σας θέσει σε λειτουργία σε λίγα λεπτά — ξεκινώντας με τον έλεγχο ταυτότητας, προχωρώντας στη δημιουργία αιτημάτων και κορυφώνοντας με πρότυπες πρακτικές για διαχείριση σφαλμάτων, σελιδοποίηση και ενσωμάτωση webhook. Σε όλη τη διάρκεια, θα βρείτε αποσπάσματα κώδικα σε Python, JavaScript, Java και C#, που δείχνουν πώς μια μόνο γραμμή κώδικα μπορεί να ενεργοποιήσει μια πλήρη σύγκριση, καθώς και ένα περιβάλλον sandbox όπου μπορείτε να πειραματιστείτε με πραγματικά αρχεία χωρίς να φύγετε από το πρόγραμμα περιήγησής σας. Στο τέλος αυτού του οδηγού, θα έχετε μια στέρεη κατανόηση του πώς να ενσωματώσετε αξιόπιστη, υψηλής πιστότητας σύγκριση υπολογιστικών φύλλων σε οποιαδήποτε ροή εργασίας, να μειώσετε τον χρόνο χειροκίνητης ανασκόπησης και να ενδυναμώσετε τα ενδιαφερόμενα μέρη με διαφανή, ελεγχόμενα αρχεία αλλαγών — όλα ενώ χρησιμοποιείτε ένα API τόσο ασφαλές και γρήγορο όσο είναι και εύκολο στη χρήση.

Κύρια Χαρακτηριστικά

Το Comparison API διαθέτει ένα εκτενές σύνολο λειτουργιών που αντιμετωπίζουν τα πιο συχνά προβλήματα που προκύπτουν κατά τη συμφωνία δεδομένων υπολογιστικών φύλλων σε διαφορετικές πλατφόρμες. Καταρχάς, το API υποστηρίζει μια πλήρη λίστα μορφών αρχείων: Apple Numbers (.numbers), αρχεία κειμένου με διαχωριστικό (CSV, TSV), παλαιότερο Excel (.xls) και σύγχρονο Excel (.xlsx). Αυτό εξαλείφει την ανάγκη για εργαλεία προμετατροπής, επιτρέποντάς σας να τροφοδοτήσετε τα αρχικά αρχεία απευθείας στην υπηρεσία. Η μηχανή diff λειτουργεί σε επίπεδο κελιού, ανιχνεύοντας αλλαγές στις τιμές, στους τύπους και ακόμη σε ιδιότητες μορφοποίησης όπως στυλ γραμματοσειράς, σκίαση κελιών και κανόνες επικύρωσης δεδομένων· κάθε διαφορά επισημαίνεται καθαρά στο παραγόμενο βιβλίο εργασίας χρησιμοποιώντας προσαρμόσιμα χρωματικά σχήματα, διευκολύνοντας τους μη‑τεχνικούς κριτές να ερμηνεύσουν το αποτέλεσμα. Για μεγάλα σύνολα δεδομένων, το API προσφέρει λειτουργία incremental comparison, που σας επιτρέπει να συγκρίνετε μόνο τις γραμμές που προστέθηκαν ή τροποποιήθηκαν από μια προηγούμενη βάση, μειώνοντας έτσι τον χρόνο επεξεργασίας και το εύρος ζώνης δικτύου. Επιπλέον, μπορείτε να ζητήσετε μια δομημένη σύνοψη JSON των αλλαγών επιπλέον του οπτικού diff αρχείου, ενεργοποιώντας αυτοματισμούς όπως ειδοποιήσεις, ενημέρωση ταμπλό ή ενσωμάτωση αλλαγών σε συστήματα ελέγχου εκδόσεων. Οι λειτουργίες ασφαλείας περιλαμβάνουν έλεγχο ταυτότητας με token OAuth 2.0, κλειδιά API με περιορισμό, και προαιρετική λευκή λίστα IP, ενώ τα δεδομένα σε ηρεμία κρυπτογραφούνται με AES‑256. Η υπηρεσία συμμορφώνεται επίσης με τα πρότυπα συμμόρφωσης GDPR και CCPA, προσφέροντας εμπιστοσύνη στη διαχείριση ευαίσθητων προσωπικών ή οικονομικών πληροφοριών. Από πλευράς απόδοσης, το API έχει σχεδιαστεί για χαμηλή καθυστέρηση· χάρη στην οριζόντια κλιμάκωση και αλγορίθμους diff στη μνήμη, οι περισσότερες συγκρίσεις ολοκληρώνονται σε λιγότερο από ένα δευτερόλεπτο για βιβλία εργασίας τυπικού μεγέθους, με υποστήριξη ασύγχρονης επεξεργασίας μέσω webhooks για αρχεία άνω των 50 MB. Τελικά, η εμπειρία του προγραμματιστή είναι κορυφαία προτεραιότητα: πλήρεις προδιαγραφές OpenAPI, αυτόματα παραγόμενα SDK, λεπτομερείς κωδικοί σφαλμάτων και κεφαλίδες περιορισμού ρυθμού σε πραγματικό χρόνο σας επιτρέπουν να ενσωματώσετε το API με ελάχιστο friction, ενώ η κονσόλα sandbox και το εκτενές αποθετήριο παραδειγμάτων παρουσιάζουν βέλτιστες υλοποιήσεις για επεξεργασία παρτίδων, pipelines CI/CD και serverless λειτουργίες. Συνοπτικά, το Comparison API προσφέρει γρήγορες, ασφαλείς και φιλικές προς τον προγραμματιστή λειτουργίες diff υπολογιστικών φύλλων που σας επιτρέπουν να εντοπίζετε αλλαγές με ένα μόνο, απλό κάλεσμα — ανεξάρτητα από τη μορφή, το μέγεθος ή την πολυπλοκότητα των δεδομένων που διαχειρίζεστε.

Έγγραφα

Παράμετροι

format: Μια υποστηριζόμενη μορφή αρχείου εξόδου.
UploadFileRequest.OperationId: Αυτό είναι ένα αναγνωριστικό λειτουργίας
UploadFileRequest.Files: Αυτά είναι τα αρχεία που πρέπει να ανεβάσετε στις διαδικτυακές μας υπηρεσίες· μπορείτε να ετοιμάσετε τα δεδομένα με τον δικό σας τρόπο, αλλά πρέπει να ακολουθούν το πρότυπο του αρχείου εισόδου HTML.

Χρήση του Endpoint

Στείλτε ένα αίτημα που περιλαμβάνει τα αρχεία και το διακριτικό πρόσβασης 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'
Η υπηρεσία θα απαντήσει με ένα URL λήψης για το επεξεργασμένο αρχείο, σε αυτό το παράδειγμα είναι:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Στείλτε ένα αίτημα που περιλαμβάνει το όνομα του αρχείου και το όνομα του φακέλου σε API Λήψης

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Θα λάβετε το αρχείο και μπορείτε είτε να το χρησιμοποιήσετε είτε απλώς να το προωθήσετε στο επόμενο βήμα της ροής εργασίας σας.