Comparaison

Bienvenue sur le hub officiel de documentation de l'API Comparison, une solution conçue spécifiquement qui transforme la tâche souvent fastidieuse de gestion de version de feuilles de calcul en un flux de travail optimisé pour les développeurs. Que vous soyez analyste de données réconciliant des rapports trimestriels, membre d'une équipe financière suivant les révisions budgétaires, ou ingénieur logiciel intégrant des capacités de diff dans un pipeline de données plus vaste, cette API est pensée pour vous accompagner là où vous êtes et éliminer les approximations lorsqu'il s'agit d'identifier les modifications à travers une large gamme de formats de feuilles de calcul. Au cœur de l'API Comparison se trouve un modèle simple mais puissant : vous fournissez deux fichiers sources — qu'ils proviennent d'Apple Numbers, d'une exportation CSV/TSV, ou de la suite Excel (.xlsx, .xls) — et le service renvoie un fichier résultat unique qui met en évidence chaque ajout, suppression et modification avec des indicateurs visuels clairs. L'accent mis sur la clarté n'est pas accessoire ; chaque différence est annotée de façon à refléter les conventions natives des feuilles de calcul (arrière-plans de cellules colorés, bulles de commentaire, marqueurs de lignes/colonnes) afin que les utilisateurs finaux puissent ouvrir le résultat dans leur application préférée et comprendre immédiatement ce qui a changé. Au‑delà du diff de base, l'API préserve également le formatage original, les formules et les types de données, garantissant que le résultat n'est pas seulement un rapport texte brut, mais un classeur fonctionnel prêt pour une analyse ou une distribution supplémentaire. La sécurité et les performances sont intégrées à chaque requête : tous les transferts de fichiers s'effectuent via TLS 1.3, les fichiers sont traités dans des conteneurs isolés avec des limites de mémoire strictes, et les résultats sont généralement renvoyés en moins d'une seconde pour des fichiers jusqu'à 10 Mo, s'adaptant de façon fluide aux ensembles de données plus volumineux grâce à un streaming par morceaux. La documentation que vous lisez actuellement est organisée pour vous permettre d'être opérationnel en quelques minutes — en commençant par l'authentification, en passant par la construction des requêtes, jusqu'aux modèles de bonnes pratiques pour la gestion des erreurs, la pagination et l'intégration de webhooks. Tout au long du guide, vous trouverez des extraits de code en Python, JavaScript, Java et C#, illustrant comment une seule ligne de code peut déclencher une comparaison complète, ainsi qu'un environnement sandbox où vous pouvez expérimenter avec de vrais fichiers sans quitter votre navigateur. Au terme de ce guide, vous disposerez d'une compréhension solide de la façon d'intégrer une comparaison fiable et haute fidélité des feuilles de calcul dans n'importe quel flux de travail, de réduire le temps de révision manuel et d'offrir aux parties prenantes des journaux de changements transparents et audités — le tout en tirant parti d'une API aussi sécurisée et rapide qu'elle est facile d'utilisation.

Fonctionnalités principales

L'API Comparison propose un ensemble complet de fonctionnalités qui répondent aux points de douleur les plus courants rencontrés lors de la réconciliation de données de feuilles de calcul sur diverses plateformes. Tout d'abord, l'API prend en charge une liste exhaustive de formats de fichiers : Apple Numbers (.numbers), fichiers délimités en texte brut (CSV, TSV), Excel hérité (.xls) et Excel moderne (.xlsx). Cela élimine le besoin d'outils de pré-conversion, vous permettant d'alimenter directement les fichiers d'origine dans le service. Le moteur de diff fonctionne au niveau des cellules, détectant les changements de valeurs, de formules et même d'attributs de format tels que le style de police, la couleur de fond des cellules et les règles de validation des données ; chaque variance est clairement mise en évidence dans le classeur résultant à l'aide de schémas de couleur personnalisables, facilitant ainsi l'interprétation par les relecteurs non techniques. Pour les ensembles de données de grande envergure, l'API offre un mode de comparaison incrémentielle, vous permettant de ne comparer que les lignes ajoutées ou modifiées depuis une base de référence précédente, réduisant ainsi le temps de traitement et la bande passante réseau. De plus, vous pouvez demander un résumé structuré JSON des changements en plus du fichier de diff visuel, permettant l'automatisation en aval telle que le déclenchement d'alertes, la mise à jour de tableaux de bord ou l'intégration des changements dans des systèmes de contrôle de version. Les fonctionnalités de sécurité comprennent l'authentification OAuth 2.0 par jeton porteur, des clés API à portée limitée et le filtrage d'adresses IP optionnel, tandis que les données au repos sont chiffrées avec AES‑256. Le service respecte également les normes de conformité GDPR et CCPA, vous assurant une confiance maximale lors du traitement d'informations personnelles ou financières sensibles. En termes de performances, l'API est conçue pour une faible latence ; grâce à une mise à l'échelle horizontale et à des algorithmes de diff en mémoire, la plupart des comparaisons s'achèvent en moins d'une seconde pour des classeurs de taille standard, avec prise en charge du traitement asynchrone via webhooks pour les fichiers dépassant 50 Mo. Enfin, l'expérience développeur est une priorité : spécifications OpenAPI complètes, SDKs auto-générés, codes d'erreur détaillés et en-têtes de limitation de débit en temps réel vous permettent d'intégrer l'API avec un minimum de friction, tandis que notre console sandbox et notre vaste dépôt d'exemples illustrent les meilleures pratiques pour le traitement par lots, les pipelines CI/CD et les fonctions serverless. En résumé, l'API Comparison offre des capacités de diff de feuilles de calcul rapides, sécurisées et conviviales pour les développeurs, vous permettant de repérer les changements avec un appel simple — quel que soit le format, la taille ou la complexité des données que vous traitez.

Documents

Paramètres

format: Un format de fichier de sortie pris en charge.
UploadFileRequest.OperationId: Il s'agit d'un identifiant d'opération.
UploadFileRequest.Files: Ce sont les fichiers que vous devez télécharger sur nos services en ligne ; vous pouvez préparer les données à votre manière, mais elles doivent respecter la norme du champ de fichier HTML.

Utiliser le point de terminaison

Envoyez une requête incluant les fichiers et le jeton d'accès. API Comparison

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.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 incluant le nom du fichier et le nom du dossier vers 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 le transmettre à l'étape suivante de votre flux de travail.