Autenticación

Para comenzar a usar los puntos finales de nuestras APIs, primero debe autenticarse. Esta guía explica cómo obtener y utilizar credenciales de autenticación con la plataforma Sheetize Cloud.

Características principales

El flujo de autenticación de Sheetize Cloud está diseñado para proteger sus datos y garantizar que solo los usuarios autorizados puedan subir archivos e invocar nuestros servicios. Proporciona:

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.

Cómo usar

Crear una aplicación

Vaya al Panel de control
Después de iniciar sesión, haga clic en el elemento de menú **Aplicaciones** de la barra de navegación izquierda.
Pulse **Crear nueva aplicación** para abrir el formulario de creación de aplicación.
En la sección *Detalles de la aplicación*, introduzca un nombre descriptivo y una breve descripción para su aplicación.
Haga clic en el botón **Guardar** para almacenar la nueva aplicación.
En la lista de aplicaciones, localice la que acaba de crear y haga clic en su nombre.
En el panel *Credenciales del cliente* verá un **Client ID** y un **Client Secret** - mantenga estos valores seguros; serán necesarios para obtener un token de acceso.

Obtener un token de acceso

Haga una solicitud a la punto final de autenticador

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Después de la ejecución recibirá el token, por favor guárdelo para uso posterior

Usar los puntos finales

Elija la API que desea llamar. En este ejemplo demostramos el servicio de Conversión, que transforma archivos de hoja de cálculo a formato PDF.
Envíe una solicitud que incluya los archivos y el token de acceso API de conversión

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'
El servicio responderá con una URL de descarga para el PDF generado, en este ejemplo es:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Envíe una solicitud que incluya el nombre del archivo y el nombre de la carpeta a API de descarga

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Recibirá el archivo y podrá usarlo o simplemente reenviarlo al siguiente paso de su flujo de trabajo.