Créer, gérer, maintenir : Guide pratique de l’Aspose.Cells Cloud Management API

Créer un classeur vide, renommer une feuille, compresser un fichier gonflé ou réparer un fichier corrompu — ce sont les petites tâches quotidiennes qui continuent de consommer du temps de développeur lorsque vous n’avez pas le bon outil. ManagementController les transforme en une seule ligne.

Chaque application qui travaille avec des feuilles de calcul finit par rencontrer les mêmes tâches peu glamour :

• Création d’un nouveau classeur vide à la volée — parfois à partir d’un modèle de marque.
• Réorganisation des feuilles de calcul — ajout, renommage, suppression, réordonnancement — parce que la forme des données a changé depuis hier.
• Maîtrise de la taille du fichier — compression d’un XLSX de 40 Mo à 8 Mo avant de l’envoyer par e‑mail.
• Récupération d’un fichier corrompu — celui qu’un utilisateur a mal enregistré, ou qu’un outil a mal exporté.
• Inspection de la structure — déterminer quelles feuilles, tableaux, graphiques et zones de cellules fusionnées se trouvent dans un classeur sans l’ouvrir.

Le ManagementController dans le microservice Aspose.Cells Cloud (source : src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) gère tout cela derrière une interface REST propre. Cet article présente ses 15 points de terminaison avec des exemples cURL exécutables que vous pouvez coller dans votre pipeline dès aujourd’hui.

1. Que fait ManagementController ?

ManagementController est le contrôleur dédié au cycle de vie et à l’entretien du classeur. Contrairement à ConversionController (conversion de format), DataProcessingController (fusion/partition/importation en masse), ou CellsController (lecture/écriture au niveau des cellules), ce contrôleur concerne la forme, la santé et les métadonnées du classeur lui‑même.

Chaque point de terminaison prend un classeur en entrée multipart (local) ou fait référence à un classeur déjà présent dans le stockage cloud (remote), et renvoie soit un flux de classeur modifié, une charge utile JSON, ou un simple OK.

2. Les quinze points de terminaison en un coup d’œil

Les routes supposent l’hôte https://api.aspose.cloud. Les appels en direct ressemblent à https://api.aspose.cloud/v4.0/cells/....

3. Avant de commencer : deux prérequis

1. Obtenez les informations d’identification. Inscrivez-vous sur Aspose Cloud Dashboard, créez une Application, récupérez le Client ID et le Client Secret. Les SDK gèrent l’échange JWT pour vous ; avec cURL, vous les échangez contre un jeton d’accès manuellement.
2. Installez un SDK — ou utilisez simplement cURL. Tout est du REST pur.

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. Démarrage rapide : créer un nouveau classeur

PUT /v4.0/cells/spreadsheet/create est la chose la plus simple que le contrôleur fait — et l’une des plus utiles. Il renvoie un tout nouveau fichier de classeur.

cURL

# 1) Get a bearer token
curl -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

# 2) Create an empty XLSX
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output new_workbook.xlsx

Utilisation d’un modèle

Si vous avez un modèle de marque — logo dans l’en-tête, couleurs de marque dans le thème, tableau “Facture” préformaté — téléchargez‑le une fois dans le stockage cloud, puis transmettez son chemin via template.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx&template=templates/invoice_branded.xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output invoice_2026_09_001.xlsx

Désormais, votre application peut générer de nouvelles factures qui sont déjà correctement formatées, sans intégrer de logique de style.

5. Guide pas à pas : gérer les feuilles de calcul dans un classeur

Ces quatre points de terminaison gèrent la forme quotidienne d’un classeur. Parcourons une séquence réaliste : vous avez téléchargé un classeur, et vous devez lister ses feuilles, en ajouter une nouvelle, renommer une existante et en supprimer une troisième.

5a. Lister les feuilles de calcul

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/worksheets" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@my_workbook.xlsx"

Response:

[
  { "WorksheetName": "Sheet1", "SheetType": "Worksheet" },
  { "WorksheetName": "Data", "SheetType": "Worksheet" },
  { "WorksheetName": "Chart1", "SheetType": "Chart" }
]

5b. Ajouter une nouvelle feuille de calcul

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet?sheetType=Worksheet&position=1&sheetName=Summary" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5c. Renommer une feuille de calcul

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Overview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5d. Supprimer une feuille de calcul

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/delete/worksheet?sheetName=Chart1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5e. Déplacer une feuille de calcul

# Move "Data" to position 0 (front of the workbook)
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?worksheet=Data&position=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

Chacun de ces points de terminaison suit le même modèle : téléverser le classeur en multipart, récupérer le classeur modifié. Enchaînez‑les dans votre pipeline, ou appelez‑les de manière ad‑hoc depuis une interface utilisateur.

6. Guide pas à pas : compresser un classeur volumineux

Un utilisateur vous a envoyé un fichier XLSX de 40 Mo dont 90 % du XML est redondant. PUT /v4.0/cells/spreadsheet/compress le compresse.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/compress?level=9" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@bloated.xlsx" \
  --output slim.xlsx

Un niveau de 9 sur un classeur typique de 40 MB aboutit souvent à une plage de 6–10 MB. Le contenu est identique ; seule la compression ZIP du conteneur XLSX est renforcée.

7. Guide pas à pas : réparer un classeur corrompu

Parfois, vous recevez un fichier qu’Excel refuse d’ouvrir. PUT /v4.0/cells/spreadsheet/repair exécute la routine de récupération du moteur et renvoie une version propre.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/repair" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@broken.xlsx" \
  --output repaired.xlsx

Pas de paramètres. Le contrôleur re‑sérialise le classeur via le moteur, qui élimine les parties corrompues et écrit un fichier structurellement valide. Toutes les corruptions ne sont pas récupérables, mais cela gère les cas courants — entrées ZIP tronquées, références de cellules invalides, chaînes partagées malformées.

8. Résumé des principaux avantages

• Un contrôleur pour les opérations du cycle de vie. Créez, restructurez, compressez, réparez, inspectez — le tout sous un même modèle d’authentification et un même contrat d’erreur.
• Création consciente du modèle. Ne réimplémentez pas le style dans votre application ; laissez le serveur intégrer un modèle dans chaque nouveau classeur.
• Variantes locales et distantes. Même logique que les fichiers soient dans le navigateur de votre utilisateur ou déjà stockés dans le cloud.
• Introspection de la structure. Le point de terminaison structure renvoie une carte JSON complète des feuilles, tableaux, tableaux croisés dynamiques, graphiques et formes — idéal pour piloter une interface utilisateur ou un pipeline de validation.
• Aucune infrastructure. Pas d’installation d’Excel, pas de COM, pas de serveur à maintenir.