Autenticazione

Per iniziare a utilizzare gli endpoint delle nostre API, è necessario autenticarsi prima. Questa guida spiega come ottenere e utilizzare le credenziali di autenticazione con la piattaforma Sheetize Cloud.

Caratteristiche Principali

Il flusso di autenticazione di Sheetize Cloud è progettato per proteggere i tuoi dati e garantire che solo gli utenti autorizzati possano caricare file e invocare i nostri servizi. Fornisce:

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.

Come Usare

Crea un'applicazione

Vai al Dashboard
Dopo aver effettuato il login, fai clic sulla voce di menu **Applicazioni** nella barra di navigazione a sinistra.
Premi **Crea Nuova Applicazione** per aprire il modulo di creazione dell'applicazione.
Nella sezione *Dettagli Applicazione*, inserisci un nome descrittivo e una breve descrizione per la tua applicazione.
Fai clic sul pulsante **Salva** per memorizzare la nuova applicazione.
Nell'elenco delle applicazioni, individua quella appena creata e fai clic sul suo nome.
Nel pannello *Credenziali Client* vedrai un **Client ID** e un **Client Secret** - conserva questi valori al sicuro; saranno necessari per ottenere un token di accesso.

Ottieni un Token di Accesso

Fai una richiesta a Endpoint Authenticator

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Dopo l'esecuzione riceverai il token, ti preghiamo di conservarlo per utilizzi futuri.

Usa gli endpoint

Scegli l'API che desideri chiamare. In questo esempio dimostriamo il servizio di Conversione, che trasforma i file di fogli di calcolo in formato PDF.
Invia una richiesta che includa i file e il token di accesso API di Conversione

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

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "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.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Riceverai il file e potrai usarlo o semplicemente inoltrarlo al passaggio successivo del tuo flusso di lavoro.