Exporter une page de feuille de calcul – Référence de l'API Aspose.Cells Cloud

L’exportation d’une page spécifique d’une feuille de calcul est utile lorsque vous avez besoin d’une version imprimable d’un rapport, d’une image de graphique ou d’un extrait de données, sans avoir à télécharger l’ensemble du classeur. Ce point de terminaison vous permet d’obtenir une seule page dans le format le mieux adapté à votre flux de travail en aval.

L’API GET /cells/{name}/worksheets/{sheetName} permet de convertir une page spécifique d’une feuille de calcul en divers formats de fichiers. Formats pris en charge : XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.

API REST

La spécification OpenAPI définit une interface de programmation accessible publiquement et vous permet d’effectuer des interactions REST directement depuis un navigateur web.

Prérequis – Vous devez disposer d’un jeton d’authentification JWT valide et du classeur stocké dans un dossier cloud spécifié via le paramètre folder.

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment effectuer un appel à l’API Cloud avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1?format=png&verticalResolution=100&horizontalResolution=90&pageIndex=1&folder=DotnetFiles" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>"

Réponse

Réponse – Le service renvoie la page demandée dans le format choisi. Pour les formats d’image (png, jpeg, gif, etc.), le corps contient l’image binaire ; pour les formats de document (pdf, xls, csv, etc.), le corps contient le contenu du fichier. Une requête réussie renvoie le code HTTP 200.

Exemple de réponse PNG (extraire base64 tronqué) :

iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABG0lEQVR42mNkYGBg+M+ABbJw
...

Paramètres

Paramètre	Type	Description	Valeur par défaut
`format`	string	Format de fichier de sortie (par ex. `pdf`, `png`, `csv`).	`pdf`
`verticalResolution`	integer	Résolution verticale (DPI) de l’image rendue.	`100`
`horizontalResolution`	integer	Résolution horizontale (DPI) de l’image rendue.	`100`
`pageIndex`	integer	Index de page de la feuille de calcul à exporter (index à zéro ; `0` = première page).	`0`
`folder`	string	Dossier de stockage cloud où réside le classeur source.	—

Codes de statut HTTP

Code	Signification	Description
200	OK	Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400	Mauvaise requête	Paramètres manquants ou non valides (par ex. type de fichier non pris en charge).
401	Non autorisé	Jeton JWT invalide ou manquant.
413	Charge utile trop volumineuse	Le fichier téléchargé dépasse la limite de taille.
500	Erreur interne du serveur	Erreur serveur inattendue.

Erreurs possibles

401 Non autorisé – Jeton JWT invalide ou manquant.
404 Non trouvé – Le classeur ou la feuille de calcul spécifié n’existe pas.
400 Mauvaise requête – Valeur de paramètre non valide (par ex. format non pris en charge).
500 Erreur interne du serveur – Problème inattendu côté serveur.

Famille de SDK Cloud

L’utilisation d’un SDK est le moyen le plus efficace d’accélérer le développement. Un SDK gère les détails de bas niveau, vous permettant ainsi de vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Exporter une zone de feuille de calcul en PNG, PDF, CSV – Aspose.Cells Cloud API