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
formatest omis. -
L’API renvoie le fichier converti dans le format demandé si le paramètre de requête
formatspé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