Conversion

L'API de métadonnées est un service créé sur mesure, convivial pour les développeurs, qui vous donne le contrôle total sur les métadonnées des fichiers de feuilles de calcul avec une simple requête HTTP. Que vous travailliez avec les formats bureautiques classiques tels qu'Excel (.xlsx, .xls), des fichiers délimités simples comme CSV (.csv) et TSV (.tsv), ou même des documents Apple Numbers (.numbers), l'API masque les complexités de l'analyse de fichier et vous permet de lire, ajouter ou modifier les propriétés descriptives clés en quelques millisecondes. Imaginez pouvoir traiter par lots des milliers de rapports, ensembles de données de recherche ou états financiers, enrichissant chaque fichier d'un ensemble cohérent d'informations d'auteur, titres, sujets, descriptions, listes de mots-clés et même de collections d'étiquettes personnalisées définies par votre application. Ce niveau d'automatisation non seulement économise d'innombrables heures d'édition manuelle mais garantit également que chaque fichier que vous livrez aux clients, collaborateurs ou systèmes d'archivage contient exactement les métadonnées nécessaires à l'indexation, à la conformité et à la découvrabilité. Le service fonctionne en acceptant soit les octets bruts du fichier, soit une URL pointant vers un document hébergé dans le cloud, puis renvoie un nouveau fichier complet avec les modifications de métadonnées demandées appliquées sans altérer la mise en page ou les formules d'origine.

Principales fonctionnalités

Étant donné que l'API est sans état, vous pouvez facilement l'intégrer aux pipelines CI/CD, aux jobs batch côté serveur ou aux widgets JavaScript côté client, en veillant à ce que chaque exportation d'une application web ou chaque sauvegarde périodique contienne les informations de provenance correctes. La sécurité est intégrée : toutes les appels sont effectués via TLS, les charges utiles sont chiffrées de bout en bout, et l'API prend en charge l'authentification par clé d'API ou OAuth 2.0, vous permettant de limiter l'accès aux services de confiance uniquement. Le moteur sous‑jacent exploite des bibliothèques d'analyse hautement optimisées pour chaque format pris en charge, garantissant que même les classeurs Excel massifs contenant des centaines de feuilles sont traités rapidement ; la plupart des requêtes typiques se terminent en moins de 200 ms. En pratique, cela signifie que vous pouvez créer un bouton « Ajouter des métadonnées » fluide dans votre produit qui envoie le fichier au service, reçoit la version enrichie et le propose en téléchargement immédiat—le tout sans que l'utilisateur quitte l'interface. L'API renvoie également des journaux d'opération détaillés, permettant aux développeurs de vérifier programmatique que les champs attendus ont bien été mis à jour, d'annuler les modifications si nécessaire, ou de déclencher d'autres étapes de traitement en fonction des valeurs d'étiquettes personnalisées. En offrant un point d’accès REST uniforme et indépendant du langage, l'API de métadonnées élimine le besoin pour les développeurs de maintenir plusieurs bibliothèques spécifiques aux formats, réduit la charge de maintenance et assure une compatibilité pérenne à mesure que de nouvelles normes de feuilles de calcul apparaissent. Que vous soyez un éditeur SaaS cherchant à intégrer des informations de licence, une institution de recherche cataloguant des ensembles de données, ou une entreprise automatisant la conformité documentaire, cette API offre une façon rapide, sécurisée et évolutive d'enrichir vos fichiers en un seul appel simple.

Documents

Paramètres

AppRequest.Metadata: Avec PropertyName et PropertyValue
AppRequest.MetadataJson: Si vous n'utilisez pas la structure Metadata, vous devez alors utiliser le type de données json.
UploadFileRequest.OperationId: Ce sont des fichiers que vous devez télécharger sur nos services en ligne ; vous pouvez préparer les données à votre façon, mais elles doivent respecter la norme du champ de saisie html.
UploadFileRequest.Files: Ce sont des fichiers que vous devez télécharger sur nos services en ligne ; vous pouvez préparer les données à votre façon, mais elles doivent respecter la norme du champ de saisie html.

Utiliser le point de terminaison

Envoyez une requête incluant les fichiers et le jeton d'accès API de métadonnées

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -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 :

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Envoyez une requête qui inclut le nom du fichier et le nom du dossier à API de téléchargement

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -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.