Clear
L'API Clear Spreadsheet est conçue pour être la solution définitive pour les développeurs qui doivent purger de manière programmatique les éléments indésirables des fichiers de feuille de calcul en un seul appel fiable. Cette page de documentation sert de guide complet, vous accompagnant à travers tout ce qui est nécessaire pour commencer à intégrer le service dans vos applications en toute confiance. Nous commençons par une présentation des concepts de base de l'API, en expliquant comment le service interprète les différents formats de feuille de calcul — allant des fichiers Office Open XML modernes (.xlsx) aux binaires Excel hérités (.xls), ainsi que Apple Numbers, CSV, TSV et de nombreuses autres représentations tabulaires. Comprendre ces nuances de types de fichiers est essentiel car chaque format stocke les hyperliens, images, graphiques et objets intégrés dans des structures distinctes ; l'API Clear abstrait ces complexités et propose une interface uniforme qui fonctionne sur tous les formats.
Fonctionnalités principales
Ensuite, vous trouverez une présentation détaillée du flux d'authentification. La plateforme utilise des clés d'API conformes aux standards de l'industrie ainsi que des jetons OAuth 2.0 optionnels pour garantir que seuls les clients autorisés puissent invoquer les opérations de nettoyage des données. Les meilleures pratiques de sécurité, telles que la rotation des clés, la mise sur liste blanche des adresses IP et la transmission chiffrée via HTTPS, sont traitées en profondeur, vous permettant de protéger à la fois votre infrastructure et les données des utilisateurs finaux. Après l'authentification, la section « Démarrage rapide » fournit un exemple de code de démarrage rapide dans plusieurs langages (cURL, Python, JavaScript, .NET et Java), illustrant comment construire la charge utile d'une requête, joindre le fichier de feuille de calcul et interpréter la réponse. L'exemple montre la requête la plus légère possible — uniquement votre clé d'API, les données du fichier et une liste facultative des types d'éléments à nettoyer — mettant en avant la promesse de l'API d'« un appel simple ».
Documents
Paramètres
- format: Le nom de l'opération, parmi : clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
- AppRequest.OperationTables: Le nom de l'opération, parmi : clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
- UploadFileRequest.OperationId: Ceci est un identifiant d'opération
- UploadFileRequest.Files: Il s'agit des fichiers que vous devez télécharger vers nos services en ligne ; vous pouvez préparer les données à votre manière, mais elles doivent respecter le standard du champ de fichier HTML.
Utiliser le point de terminaison
-
Envoyez une requête incluant les fichiers et le jeton d'accès Clear API
curl -X 'POST' \ 'https://api.sheetize.cloud/clear' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.OperationTables=clearHyperlinks' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Le service répondra avec une URL de téléchargement pour le fichier traité, dans cet exemple c'est :
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Envoyez une requête incluant le nom du fichier et le nom du dossier à Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Vous recevrez le fichier et pourrez soit l'utiliser, soit le transmettre à l'étape suivante de votre flux de travail.
