Autenticazione
Per iniziare a utilizzare gli endpoint delle nostre API, devi prima autenticarti. 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 Invia una richiesta che includa il nome del file e della cartella a
- Dopo aver effettuato l'accesso, 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.
- Fai clic sul pulsante **Salva** per memorizzare la nuova applicazione.
- Fai clic sul pulsante **Salva** per memorizzare la nuova applicazione.
- Nel pannello *Credenziali Client* vedrai un **ID client** e un **Segreto client** – conserva questi valori al sicuro; saranno richiesti per ottenere un token di accesso.
- Nel pannello *Credenziali Client* vedrai un **ID client** e un **Segreto client** – conserva questi valori al sicuro; saranno richiesti per ottenere un token di accesso.
Ottieni un Token di Accesso
-
Effettua una richiesta al Endpoint Authenticator
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - Al termine riceverai il token; conservalo 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 foglio 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 della cartella a HowToUse111
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 passo successivo del tuo workflow.