Aspose.Cells Cloud – Convertir un classeur Excel en PDF, CSV, HTML et plus (GET /cells/{name})

Cette API REST permet de récupérer un classeur Excel dans un format différent.

API GetWorkBook

GET https://api.aspose.cloud/v3.0/cells/{name}

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.

Paramètres de requête

Nom du paramètre Type Description Valeur par défaut
format string Format cible du fichier (par ex., CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, etc.).
password string Mot de passe requis pour ouvrir le fichier Excel.
isAutoFit bool Ajuste automatiquement la largeur des lignes et des colonnes. false
onlySaveTable bool Si true, seules les données du tableau sont enregistrées. Accepte true ou false. false
outPath string Chemin d’enregistrement du résultat. Pour un fichier unique, inclure le nom du fichier et son extension ; pour plusieurs fichiers, spécifier uniquement le dossier.
outStorageName string Nom du stockage dans lequel le fichier de sortie sera enregistré.
checkExcelRestriction bool Vérifie les restrictions Excel lors de la modification des cellules ou des objets associés. false
region string Paramètres régionaux appliqués au classeur.
pageWideFitOnPerSheet bool Ajuste la largeur de page à chaque feuille de calcul lors de la conversion en PDF. false
pageTallFitOnPerSheet bool Ajuste la hauteur de page à chaque feuille de calcul lors de la conversion en PDF. false
onePagePerSheet bool Génère une page PDF par feuille de calcul. false
folder string Chemin du dossier contenant le classeur original.
storageName string Nom du stockage où se trouve le fichier source.

Réponse

Succès (200)

  • L’API renvoie un objet Workbook contenant des informations sur la structure du classeur si le paramètre de requête format est omis.

  • L’API renvoie le fichier converti dans le format demandé si le paramètre de requête format spécifie un type de fichier.

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456

(données binaires PDF)

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 invalides (par ex., type de fichier non pris en charge).
401 Non autorisé Jeton JWT invalide ou manquant.
413 Charge utile trop grande Le fichier envoyé dépasse la limite de taille.
500 Erreur interne du serveur Erreur serveur inattendue.

Notes :

  • Les grands classeurs peuvent nécessiter plus de temps pour être convertis ; envisagez d’augmenter le délai d’expiration de la requête.
  • Certains formats (par ex., ODS) ne sont pas pris en charge pour certaines fonctionnalités Excel, telles que les macros.

Comment utiliser l’API GetWorkBook avec les SDK

Prérequis :

  • Un jeton d’accès JWT valide obtenu via le flux d’authentification Aspose.Cells.
  • Le classeur source doit être stocké dans un stockage pris en charge par Aspose ou être fourni directement dans la requête.
  • Assurez-vous que la version de l’API (v3.0) correspond à la version la plus récente publiée.

Spécification de l’API GetWorkBook

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

Exemple de requête

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder aux services web Aspose.Cells. L’exemple ci-dessous illustre une requête GET correcte avec l’en-tête d’autorisation requis.

Utiliser les SDK Aspose.Cells Cloud

L’utilisation d’un SDK constitue la méthode la plus rapide pour développer. Un SDK masque les détails de bas niveau afin que vous puissiez 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 montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Voir aussi


Dernière mise à jour : 2024-12-01