Autentifikácia

Ak chcete začať používať koncové body našich API, musíte sa najprv autentifikovať. Tento sprievodca vysvetľuje, ako získať a používať autentifikačné poverenia na platforme Sheetize Cloud.

Hlavné funkcie

Tok autentifikácie služby Sheetize Cloud je navrhnutý tak, aby chránil vaše údaje a zabezpečil, že len oprávnení používatelia môžu nahrávať súbory a vyvolávať 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.

Ako použiť

Vytvoriť aplikáciu

Prejdite na Panel
Po prihlásení kliknite na položku **Aplikácie** v ľavom navigačnom paneli.
Stlačte **Vytvoriť novú aplikáciu** na otvorenie formulára na vytvorenie aplikácie.
V sekcii *Detaily aplikácie* zadajte opisný názov a krátky opis vašej aplikácie.
Kliknite na tlačidlo **Uložiť** pre uloženie novej aplikácie.
V zozname aplikácií nájdite tú, ktorú ste práve vytvorili, a kliknite na jej názov.
V paneli *Klientske poverenia* uvidíte **Client ID** a **Client Secret** – uchovajte tieto hodnoty v bezpečí; budú potrebné na získanie prístupového tokenu.

Získať prístupový token

Vykonajte požiadavku na Endpoint autentifikátora

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Po vykonaní dostanete token, prosím uložte ho na neskoršie použitie

Použiť koncové body

Vyberte API, ktoré chcete použiť. V tomto príklade demonštrujeme službu Konverzia, ktorá prevádza tabuľkové súbory do formátu PDF.
Pošlite požiadavku, ktorá obsahuje súbory a prístupový token API konverzie

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 odpovie s odkazom na stiahnutie vygenerovaného PDF, v tomto príklade je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Pošlite požiadavku, ktorá obsahuje názov súboru a názov priečinka na API sťahovania

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte súbor a môžete ho použiť alebo jednoducho odovzdať do ďalšieho kroku vášho pracovného postupu.