Autentizace

Chcete-li začít používat koncové body našich API, musíte se nejprve autentizovat. Tento průvodce vysvětluje, jak získat a použít autentizační pověření na platformě Sheetize Cloud.

Hlavní funkce

Autentizační tok Sheetize Cloud je navržen tak, aby chránil vaše data a zajistil, že pouze autorizovaní uživatelé mohou nahrávat soubory a volat naše služby. Poskytuje:

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 použít

Vytvořit aplikaci

Přejděte na Přehled
Po přihlášení klikněte na položku **Aplikace** v levém navigačním panelu.
Stiskněte **Vytvořit novou aplikaci** a otevře se formulář pro vytvoření aplikace.
V sekci *Podrobnosti aplikace* zadejte popisný název a krátký popis vaší aplikace.
Klikněte na tlačítko **Uložit** pro uložení nové aplikace.
V seznamu aplikací najděte tu, kterou jste právě vytvořili, a klikněte na její název.
V panelu *Client Credentials* uvidíte **Client ID** a **Client Secret** – uchovejte tyto hodnoty v bezpečí; budou potřeba k získání přístupového tokenu.

Získat přístupový token

Pošlete požadavek na koncový bod Authenticatoru

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Po provedení obdržíte token, prosím uložte jej pro pozdější použití

Použít koncové body

Vyberte API, které chcete volat. V tomto příkladu ukazujeme službu Conversion, která převádí soubory tabulek do formátu PDF.
Pošlete požadavek, který zahrnuje soubory a přístupový token 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'
Služba odpoví URL pro stažení vygenerovaného PDF, v tomto příkladu je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Pošlete požadavek, který zahrnuje název souboru a název složky, na Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte soubor a můžete jej buď použít, nebo jej jednoduše předat do dalšího kroku vašeho pracovního postupu.