Επαλήθευση
Για να αρχίσετε να χρησιμοποιείτε τα endpoints των API μας, πρέπει πρώτα να ταυτοποιηθείτε. Αυτός ο οδηγός εξηγεί πώς να αποκτήσετε και να χρησιμοποιήσετε διαπιστευτήρια ταυτοποίησης με την πλατφόρμα Sheetize Cloud.
Κύρια Χαρακτηριστικά
Η ροή ταυτοποίησης του Sheetize Cloud έχει σχεδιαστεί για να προστατεύει τα δεδομένα σας και να διασφαλίζει ότι μόνο εξουσιοδοτημένοι χρήστες μπορούν να ανεβάσουν αρχεία και να καλέσουν τις υπηρεσίες μας. Παρέχει:
- Secure, token-based access that can be revoked at any time.
- Support for both machine-to-machine and user-driven scenarios.
- Granular scopes that let you limit what a token can do.
Πώς να Χρησιμοποιήσετε
Δημιουργήστε μια εφαρμογή
- Μεταβείτε στο Πίνακας Ελέγχου
- Μετά τη σύνδεση, κάντε κλικ στο στοιχείο μενού **Εφαρμογές** στη αριστερή γραμμή πλοήγησης.
- Πατήστε **Δημιουργία Νέας Εφαρμογής** για να ανοίξετε τη φόρμα δημιουργίας εφαρμογής.
- Στην ενότητα *Λεπτομέρειες Εφαρμογής*, εισάγετε ένα περιγραφικό όνομα και μια σύντομη περιγραφή για την εφαρμογή σας.
- Κάντε κλικ στο κουμπί **Αποθήκευση** για να αποθηκεύσετε τη νέα εφαρμογή.
- Στη λίστα των εφαρμογών, βρείτε αυτή που μόλις δημιουργήσατε και κάντε κλικ στο όνομά της.
- Στο πάνελ *Διαπιστευτήρια Πελάτη* θα δείτε ένα **Client ID** και ένα **Client Secret** - διατηρήστε αυτές τις τιμές ασφαλείς· θα χρειαστούν για την απόκτηση διακριτικού πρόσβασης.
Απόκτηση Διακριτικού Πρόσβασης
-
Κάντε αίτηση στο Τελικό σημείο Authenticator
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - Μετά την εκτέλεση θα λάβετε το διακριτικό, παρακαλούμε αποθηκεύστε το για μελλοντική χρήση.
Χρησιμοποιήστε τα endpoints
- Επιλέξτε το API που θέλετε να καλέσετε. Σε αυτό το παράδειγμα δείχνουμε την υπηρεσία Conversion, η οποία μετατρέπει αρχεία λογιστικού φύλλου σε μορφή PDF.
-
Στείλτε ένα αίτημα που περιλαμβάνει τα αρχεία και το διακριτικό πρόσβασης API Μετατροπής
curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Η υπηρεσία θα απαντήσει με ένα URL λήψης για το δημιουργημένο PDF, σε αυτό το παράδειγμα είναι:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
Στείλτε ένα αίτημα που περιλαμβάνει το όνομα αρχείου και το όνομα φακέλου προς API Λήψης
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Θα λάβετε το αρχείο και μπορείτε είτε να το χρησιμοποιήσετε είτε να το προωθήσετε στο επόμενο βήμα της ροής εργασίας σας.