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 identifiants d'authentification avec la plateforme Sheetize Cloud.

Fonctionnalités principales

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écharger 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 l'utiliser

Créer une application

Allez à la Tableau de bord
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.
Dans la section *Détails de l'application*, saisissez un nom descriptif et une brève description de votre application.
Cliquez sur le bouton **Enregistrer** pour sauvegarder la nouvelle application.
Dans la liste des applications, localisez celle que vous venez de créer et cliquez sur son nom.
Dans le panneau *Identifiants client*, vous verrez un **Client ID** et un **Client Secret** – 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 Authenticator

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Après l'exécution, vous recevrez le jeton, veuillez le conserver 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 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 à API de téléchargement

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