Compress

Bienvenue dans la documentation officielle de Compress, l'API légère mais puissante conçue pour réduire les fichiers de feuilles de calcul à une fraction de leur taille d'origine avec une seule requête intuitive. Dans le monde axé sur les données d'aujourd'hui, les équipes échangent constamment des feuilles de calcul contenant tout, des listes simples aux modèles financiers complexes, et le volume de ces fichiers peut rapidement devenir un coût caché — téléchargements plus lents, frais de stockage accrus et temps de traitement plus longs pour les systèmes en aval. Compress répond à ces points douloureux en offrant un service cloud‑native qui analyse intelligemment la structure interne de votre feuille de calcul, élimine les éléments superflus et regroupe le contenu sous forme optimisée et compacte sans sacrifier l'intégrité ni la lisibilité des données. Cette page de documentation constitue votre source unique de vérité, vous guidant à travers tout ce que vous devez savoir pour utiliser l'API efficacement, de l'authentification et du formatage des requêtes à la gestion des erreurs et aux meilleures pratiques pour le traitement par lots. Que vous soyez un ingénieur back‑end expérimenté intégrant des pipelines de données, un développeur front‑end cherchant à améliorer l'expérience utilisateur lors du téléchargement de fichiers, ou un responsable IT chargé de réduire l'encombrement de stockage dans votre organisation, ce guide fournira des instructions claires, pas à pas, des extraits de code dans plusieurs langages et des exemples concrets illustrant comment obtenir les meilleurs résultats de compression pour une grande variété de formats de feuilles de calcul. Tout au long de la documentation, vous trouverez des sections dédiées aux considérations de sécurité — telles que le chiffrement TLS, les jetons JWT signés et la conformité GDPR pour la gestion des données — ainsi que des benchmarks de performance démontrant la latence et le débit typiques sous différentes charges de travail. Nous incluons également une FAQ exhaustive couvrant les scénarios courants, une matrice de dépannage pour une diagnosis rapide des problèmes, et des liens vers les forums communautaires où vous pouvez partager vos connaissances avec d’autres développeurs utilisant Compress en production. À la fin de ce guide, vous serez capable de configurer vos environnements, d’envoyer un appel API correctement formé et d’interpréter les réponses, afin d’intégrer la compression de façon transparente dans vos workflows existants et de commencer à réaliser des économies concrètes sur les coûts de stockage et la bande passante réseau dès maintenant. Plongez‑y, explorez les sections correspondant à votre rôle, et laissez Compress gérer la lourde tâche de réduction des données afin que vous puissiez vous concentrer sur la création d’applications plus riches et plus réactives.

Fonctionnalités principales

Le cœur de l'API Compress repose sur un ensemble de fonctionnalités riches qui rendent la réduction des feuilles de calcul à la fois simple et fiable. Tout d'abord, le service prend en charge un large éventail de types de fichiers — notamment Apple Numbers, les fichiers CSV et TSV simples, ainsi que les formats .xlsx et .xls de Microsoft Excel — vous permettant d'envoyer pratiquement n'importe quelle feuille de calcul sans étape de pré‑conversion. En coulisses, le moteur effectue une optimisation en plusieurs phases : il normalise la structure XML ou binaire interne du fichier, élimine les styles dupliqués, fusionne les formats de cellules identiques, supprime les lignes et colonnes cachées qui ne contiennent aucune donnée, et compacte les objets intégrés tels que les images, graphiques et tableaux croisés dynamiques en appliquant des algorithmes de compression sans perte adaptés à chaque charge utile. De plus, l'API détecte et supprime les métadonnées, commentaires et informations de version redondants qui gonflent généralement la taille du fichier sans réelle utilité. Toutes ces opérations s'exécutent en temps réel, délivrant des résultats en quelques millisecondes pour des fichiers jusqu'à 50 Mo, et s'adaptent de façon fluide aux documents plus volumineux grâce à un throttling élégant et des callbacks de progression. La sécurité est intégrée — chaque requête est transmise via HTTPS, et le service ne conserve jamais de copie du fichier au‑delà de la courte fenêtre de traitement, assurant la conformité aux réglementations strictes en matière de confidentialité. Du point de vue du développeur, l'API est conçue pour être aussi frictionless que possible : un simple POST vers le point de terminaison `/compress` avec le fichier joint en multipart/form‑data renvoie une réponse JSON contenant l'URL de téléchargement du nouveau fichier, les tailles d'origine et compressée, ainsi qu'une somme de contrôle pour vérification. Des paramètres optionnels vous permettent d'ajuster finement le niveau de compression, de préserver des feuilles spécifiques, ou de mettre sur liste blanche certains objets intégrés si vous devez conserver une pleine fidélité pour les applications en aval. Des SDK complets sont disponibles pour Python, Node.js, Java et Go, chacun exposant une méthode wrapper concise — `compressSpreadsheet(filePath, options)` — qui abstrait entièrement la couche HTTP. Une documentation détaillée sur les limites de taux et des points de terminaison d'upload en masse vous permettent de traiter des milliers de fichiers par heure sans surcharger votre infrastructure, tandis que la logique de réessai intégrée et la gestion exponentielle du back‑off maintiennent vos pipelines robustes face aux petites interruptions réseau. En bref, l'API Compress fournit une solution rapide, sécurisée et conviviale pour les développeurs, qui réduit l'empreinte de stockage des feuilles de calcul, accélère les transferts de fichiers et simplifie les workflows de gestion des données avec un simple appel.

Documents

Paramètres

AppRequest.CompressionLevel: Le niveau de compression de un à neuf (1 à 9)
UploadFileRequest.OperationId: Ceci est un identifiant d'opération
UploadFileRequest.Files: Il s'agit de fichiers que vous devez télécharger vers nos services en ligne ; vous pouvez préparer les données comme vous le souhaitez, mais elles doivent respecter le standard du champ d'entrée HTML de type fichier.

Utiliser le point de terminaison

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

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -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 à 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.