Uwierzytelnianie

Aby rozpocząć korzystanie z punktów końcowych naszych API, musisz najpierw się uwierzytelnić. Ten przewodnik wyjaśnia, jak uzyskać i używać danych uwierzytelniających w platformie Sheetize Cloud.

Główne funkcje

Proces uwierzytelniania w Sheetize Cloud został zaprojektowany, aby chronić Twoje dane i zapewnić, że tylko autoryzowani użytkownicy mogą przesyłać pliki i wywoływać nasze usługi. Zapewnia on:

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.

Jak używać

Utwórz aplikację

Przejdź do Panel sterowania
Po zalogowaniu kliknij pozycję menu **Applications** w lewym pasku nawigacji.
Naciśnij **Create New Application**, aby otworzyć formularz tworzenia aplikacji.
W sekcji *Application Details* wprowadź opisową nazwę oraz krótką charakterystykę swojej aplikacji.
Kliknij przycisk **Save**, aby zapisać nową aplikację.
Na liście aplikacji znajdź tę, którą właśnie stworzyłeś, i kliknij jej nazwę.
W panelu *Client Credentials* zobaczysz **Client ID** oraz **Client Secret** – zachowaj te wartości w bezpiecznym miejscu; będą potrzebne do uzyskania tokenu dostępu.

Uzyskaj token dostępu

Wykonaj żądanie do Authenticator endpoint

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Po wykonaniu otrzymasz token, proszę go zachować do późniejszego użycia

Użyj punktów końcowych

Wybierz API, które chcesz wywołać. W tym przykładzie demonstrujemy usługę Konwersji, która przekształca pliki arkuszy kalkulacyjnych do formatu PDF.
Wyślij żądanie, które zawiera pliki oraz token dostępu Conversion 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'
Usługa zwróci URL do pobrania wygenerowanego PDF, w tym przykładzie jest to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Wyślij żądanie, które zawiera nazwę pliku i nazwę folderu do Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Otrzymasz plik i możesz go użyć lub po prostu przekazać do kolejnego kroku w swoim przepływie pracy.