Convertir un fichier Excel vers différents formats
Avant d’appeler cette API, assurez-vous d’avoir obtenu un jeton JWT valide et que le classeur source est stocké dans un emplacement pris en charge (par exemple, Aspose Cloud Storage). Incluez le jeton dans l’en-tête Authorization et, si nécessaire, spécifiez le paramètre de requête storageName.
Cette API REST permet de convertir un fichier Excel vers divers formats de sortie.
API PutConvertWorkBook
PUT https://api.aspose.cloud/v3.0/cells/convert
La requête est une requête HTTP PUT avec un contenu multipart (voir RFC 2046 ou RFC 1341).
La première partie du corps multipart contient le fichier de données, tandis que la deuxième partie contient les options d’enregistrement.
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.
Paramètres de requête
| Nom du paramètre | Type | Description |
|---|---|---|
format |
string | Format cible du fichier (par exemple, CSV, XLS, HTML, PDF, XML, TXT, TIFF, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, etc.). |
password |
string | Mot de passe requis pour ouvrir le fichier Excel source. |
outPath |
string | Chemin complet (y compris le nom de fichier et l’extension) pour un fichier de sortie unique, ou chemin de dossier lors de la génération de plusieurs fichiers. |
storageName |
string | Nom du stockage où réside le fichier source. |
checkExcelRestriction |
bool | Si true, valide les restrictions Excel avant de modifier les cellules ou les objets associés. |
streamFormat |
string | Format du flux de fichier d’entrée. |
region |
string | Paramètres régionaux appliqués au classeur. |
pageWideFitOnPerSheet |
bool | Ajuste la largeur de page pour qu’elle s’adapte à chaque feuille de calcul lors de la conversion en PDF. |
pageTallFitOnPerSheet |
bool | Ajuste la hauteur de page pour qu’elle s’adapte à chaque feuille de calcul lors de la conversion en PDF. |
sheetName |
string | Nom de la feuille de calcul à convertir. |
pageIndex |
string | Index de la page à convertir (nécessite sheetName). |
onePagePerSheet |
bool | Si true, génère une page PDF par feuille de calcul. |
AutoRowsFit |
bool | Ajuste automatiquement la hauteur de toutes les lignes du classeur. |
AutoColumnsFit |
bool | Ajuste automatiquement la largeur des colonnes du classeur. |
Paramètres du corps de la requête
| Nom du paramètre | Type | Description |
|---|---|---|
datafile |
data file | Le fichier Excel placé dans la première partie du corps multipart. |
SaveOptions |
object | Options d’enregistrement placées dans la deuxième partie du corps multipart. |
Réponse
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
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 exemple, type de fichier non pris en charge). |
| 401 | Non autorisé | Jeton JWT invalide ou manquant. |
| 413 | Charge utile trop grande | Le fichier téléchargé dépasse la taille limite. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Comment utiliser l’API PutConvertWorkBook avec les SDK
Spécification de l’API PutConvertWorkBook
La Spécification OpenAPI définit une interface accessible publiquement qui permet des interactions REST directes depuis un navigateur web.
Exemple cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
-H "accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-d '{"File":{}}'
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK accélère le développement en gérant les détails de bas niveau, ce qui vous permet de vous concentrer sur la logique métier. Consultez 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 :