Autenticação

Para começar a usar os endpoints das nossas APIs, você deve primeiro autenticar. Este guia explica como obter e usar credenciais de autenticação com a plataforma Sheetize Cloud.

Principais Funcionalidades

O fluxo de autenticação do Sheetize Cloud foi projetado para proteger seus dados e garantir que apenas usuários autorizados possam enviar arquivos e invocar nossos serviços. Ele oferece:

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.

Como Usar

Criar uma aplicação

Vá para o Painel
Depois de fazer login, clique no item de menu **Applications** na barra de navegação à esquerda.
Pressione **Create New Application** para abrir o formulário de criação de aplicação.
Na seção *Application Details*, insira um nome descritivo e uma breve descrição para sua aplicação.
Clique no botão **Save** para armazenar a nova aplicação.
Na lista de aplicações, localize a que você acabou de criar e clique no nome dela.
No painel *Client Credentials* você verá um **Client ID** e um **Client Secret** – mantenha esses valores em segurança; eles serão necessários para obter um token de acesso.

Obter um Token de Acesso

Faça uma requisição ao endpoint Authenticator

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Após a execução, você receberá o token; por favor, armazene-o para uso futuro.

Usar os endpoints

Escolha a API que deseja chamar. Neste exemplo demonstramos o serviço de Conversão, que transforma arquivos de planilha em formato PDF.
Envie uma requisição que inclua os arquivos e o token de acesso API de Conversão

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'
O serviço responderá com uma URL de download para o PDF gerado, neste exemplo é:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Envie uma requisição que inclua o nome do arquivo e o nome da pasta para API de Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Você receberá o arquivo e poderá usá‑lo ou simplesmente encaminhá‑lo para a próxima etapa do seu fluxo de trabalho.