Μετατροπή
Το Metadata API είναι μια ειδικά κατασκευασμένη, φιλική προς τους προγραμματιστές υπηρεσία που σας δίνει πλήρη έλεγχο των μεταδεδομένων αρχείων υπολογιστικών φύλλων με ένα μόνο αίτημα HTTP. Είτε εργάζεστε με κλασικές μορφές γραφείου όπως Excel (.xlsx, .xls), απλά διαχωρισμένα αρχεία όπως CSV (.csv) και TSV (.tsv), ή ακόμη και έγγραφα Apple Numbers (.numbers), το API αφαιρεί τις πολυπλοκότητες της ανάλυσης αρχείων και σας επιτρέπει να διαβάζετε, προσθέτετε ή τροποποιείτε βασικές περιγραφικές ιδιότητες σε δευτερόλεπτα χιλιοστών. Φανταστείτε τη δυνατότητα να επεξεργάζεστε κατά δέσμη χιλιάδες αναφορές, σύνολα ερευνητικών δεδομένων ή οικονομικές καταστάσεις, εμπλουτίζοντας κάθε αρχείο με ένα συνεπές σύνολο πληροφοριών συγγραφέα, τίτλων, θεμάτων, περιγραφών, λιστών λέξεων‑κλειδιών, ακόμη και προσαρμοσμένων ετικετών που ορίζει η δική σας εφαρμογή. Αυτή η αυτοματοποίηση όχι μόνο εξοικονομεί ατελείωτες ώρες χειροκίνητης επεξεργασίας, αλλά επίσης εγγυάται ότι κάθε αρχείο που αποστέλλετε σε πελάτες, συνεργάτες ή αρχειοθετικούς συστήματα φέρει τα ακριβή μεταδεδομένα που χρειάζεστε για ευρετηρίαση, συμμόρφωση και ανακαλύψιμότητα. Η υπηρεσία λειτουργεί δέχοντας είτε τα ακατέργαστα bytes του αρχείου είτε ένα URL που δείχνει σε ένα έγγραφο φιλοξενούμενο στο cloud, και στη συνέχεια επιστρέφει ένα νέο, πλήρως διαμορφωμένο αρχείο με τις αιτηθείσες αλλαγές μεταδεδομένων εφαρμόζοντας τα χωρίς να τροποποιεί την αρχική διάταξη ή τους τύπους.
Κύρια Χαρακτηριστικά
Καθώς το API είναι αstateless, μπορείτε εύκολα να το ενσωματώσετε σε CI/CD pipelines, εργασίες batch στο server ή JavaScript widgets στην πλευρά του πελάτη, διασφαλίζοντας ότι κάθε εξαγωγή από μια web εφαρμογή ή κάθε περιοδικό backup περιέχει τις σωστές πληροφορίες προέλευσης. Η ασφάλεια είναι εγγενής: όλες οι κλήσεις γίνονται μέσω TLS, τα payloads κρυπτογραφούνται end‑to‑end, και το API υποστηρίζει αυθεντικοποίηση με API‑key ή OAuth 2.0, επιτρέποντάς σας να περιορίσετε την πρόσβαση μόνο σε αξιόπιστες υπηρεσίες. Η υποκείμενη μηχανή εκμεταλλεύεται εξαιρετικά βελτιστοποιημένες βιβλιοθήκες ανάλυσης για κάθε υποστηριζόμενη μορφή, εγγυώμενη ότι ακόμη και τεράστια αρχεία Excel με εκατοντάδες φύλλα επεξεργάζονται γρήγορα· οι περισσότερες τυπικές αιτήσεις ολοκληρώνονται σε κάτω από 200 ms. Στην πράξη, αυτό σημαίνει ότι μπορείτε να δημιουργήσετε ένα αδιάλειπτο κουμπί "Προσθήκη Μεταδεδομένων" στο προϊόν σας που στέλνει το αρχείο στην υπηρεσία, λαμβάνει την εμπλουτισμένη έκδοση και την προσφέρει για άμεση λήψη—χωρίς ο χρήστης να φύγει από το περιβάλλον. Το API επίσης επιστρέφει λεπτομερή logs λειτουργίας, ώστε οι προγραμματιστές να μπορούν προγραμματιστικά να επαληθεύσουν ότι τα αναμενόμενα πεδία ενημερώθηκαν, να επαναφέρουν αλλαγές αν χρειαστεί, ή να ενεργοποιούν περαιτέρω βήματα επεξεργασίας βάσει τιμών προσαρμοσμένων ετικετών. Παρέχοντας ένα ενιαίο, γλώσσα‑ανεξάρτητο REST endpoint, το Metadata API εξαλείφει την ανάγκη για προγραμματιστές να διατηρούν πολλαπλές βιβλιοθήκες ανά μορφή, μειώνει το κόστος συντήρησης και εξασφαλίζει συμβατότητα για το μέλλον καθώς εμφανίζονται νέες προδιαγραφές υπολογιστικών φύλλων. Είτε είστε προμηθευτής SaaS που θέλει να ενσωματώσει πληροφορίες αδειοδότησης, είτε ερευνητικό ίδρυμα που κατηγοριοποιεί σύνολα δεδομένων, είτε επιχείρηση που αυτοματοποιεί τη συμμόρφωση εγγράφων, αυτό το API προσφέρει έναν γρήγορο, ασφαλή και κλιμακούμενο τρόπο να εμπλουτίζετε τα αρχεία σας με ένα απλό κάλεσμα.
Έγγραφα
Παράμετροι
- AppRequest.Metadata: Με PropertyName και PropertyValue
- AppRequest.MetadataJson: Εάν δεν χρησιμοποιείτε τη δομή Metadata, πρέπει να χρησιμοποιήσετε τύπο δεδομένων json.
- UploadFileRequest.OperationId: Αυτά είναι αρχεία που πρέπει να ανεβάσετε στις online υπηρεσίες μας· μπορείτε να προετοιμάσετε τα δεδομένα με τον δικό σας τρόπο, αλλά πρέπει να ακολουθεί το πρότυπο του html input file.
- UploadFileRequest.Files: Αυτά είναι αρχεία που πρέπει να ανεβάσετε στις online υπηρεσίες μας· μπορείτε να προετοιμάσετε τα δεδομένα με τον δικό σας τρόπο, αλλά πρέπει να ακολουθεί το πρότυπο του html input file.
-
Στείλτε ένα αίτημα που περιλαμβάνει τα αρχεία και το access token Metadata API
curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Η υπηρεσία θα απαντήσει με ένα URL λήψης για το επεξεργασμένο αρχείο· στο παράδειγμα αυτό είναι:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Στείλτε ένα αίτημα που περιλαμβάνει το όνομα αρχείου και το όνομα φακέλου στο Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Θα λάβετε το αρχείο και μπορείτε είτε να το χρησιμοποιήσετε είτε απλώς να το προωθήσετε στο επόμενο βήμα της ροής εργασίας σας.