Authentification

Pour commencer à utiliser les points de terminaison de nos API, vous devez d'abord vous authentifier. Ce guide explique comment obtenir et utiliser les informations d'identification d'authentification avec la plateforme Sheetize Cloud.

Principales fonctionnalités

Le flux d'authentification de Sheetize Cloud est conçu pour protéger vos données et garantir que seuls les utilisateurs autorisés peuvent téléverser des fichiers et invoquer nos services. Il offre :

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.

Comment utiliser

Créer une application

Accédez au Envoyez une requête incluant le nom du fichier et le nom du dossier à
Après vous être connecté, cliquez sur l'élément de menu **Applications** dans la barre de navigation à gauche.
Cliquez sur **Créer une nouvelle application** pour ouvrir le formulaire de création d'application.
Cliquez sur le bouton **Enregistrer** pour sauvegarder la nouvelle application.
Cliquez sur le bouton **Enregistrer** pour sauvegarder la nouvelle application.
Dans le panneau *Identifiants client* vous verrez un **ID client** et un **secret client** – conservez ces valeurs en lieu sûr ; elles seront nécessaires pour obtenir un jeton d'accès.
Dans le panneau *Identifiants client* vous verrez un **ID client** et un **secret client** – conservez ces valeurs en lieu sûr ; elles seront nécessaires pour obtenir un jeton d'accès.

Obtenir un jeton d'accès

Effectuez une requête vers le Point de terminaison d'authentification

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Après l'exécution, vous recevrez le jeton, veuillez le stocker pour une utilisation ultérieure

Utiliser les points de terminaison

Choisissez l'API que vous souhaitez appeler. Dans cet exemple nous présentons le service de Conversion, qui transforme les fichiers de tableur en format PDF.
Envoyez une requête incluant les fichiers et le jeton d'accès API de conversion

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'
Le service répondra avec une URL de téléchargement pour le PDF généré, dans cet exemple :

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Envoyez une requête incluant le nom du fichier et le nom du dossier à HowToUse111

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Vous recevrez le fichier et vous pouvez soit l'utiliser, soit le transmettre simplement à l'étape suivante de votre flux de travail.