Enregistrer un classeur Excel – API Aspose.Cells Cloud

Cette API REST vous permet d’enregistrer un fichier Excel dans différents formats.
Avant d’appeler ce point de terminaison, assurez-vous de disposer d’un jeton d’accès OAuth 2.0 valide et que le classeur source est stocké dans votre espace de stockage Aspose Cloud.

Prérequis

Obtenez un jeton d’accès JWT et incluez-le dans l’en-tête Authorization: Bearer <token> de chaque requête.
Téléversez le classeur source vers l’espace de stockage Aspose Cloud (ou confirmez qu’il existe déjà).
Connaître le nom de l’espace de stockage et le chemin du dossier contenant le classeur.

API PostWorkbookSaveAs

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

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification par jeton JWT.

Paramètre de chemin

Nom du paramètre	Type	Description
name	string	Nom du fichier Excel.

Paramètre de requête

Nom du paramètre	Type	Description
newfilename	string	Nom du nouveau fichier à enregistrer.
isAutoFitRows	string	Si `true`, ajuste automatiquement la hauteur de toutes les lignes du classeur. Par défaut : `false`.
isAutoFitColumns	string	Si `true`, ajuste automatiquement la largeur des colonnes du classeur. Par défaut : `false`.
folder	string	Dossier contenant le classeur original.
storageName	string	Nom de l’espace de stockage où se trouve le fichier source.
outStorageName	string	Nom de l’espace de stockage où le fichier de sortie sera enregistré.
checkExcelRestriction	bool	Indique s’il faut appliquer les restrictions Excel lors de la modification des cellules ou des objets associés.
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.
pageTallFitOnPerSheet	bool	Ajuste la hauteur de page à chaque feuille de calcul lors de la conversion.
sheetName	string	Nom de la feuille de calcul à convertir.
pageIndex	string	Index de la page à convertir dans la feuille spécifiée (nécessite `sheetName`).
onePagePerSheet	bool	Lors de la conversion au format PDF, génère une page par feuille de calcul.

Paramètre du corps de la requête

Nom du paramètre	Type	Description
SaveOptions	Object	Options d’enregistrement fournies dans la deuxième partie de la requête multipart.

Exemple de corps de requête (partie JSON de la requête multipart)

{
  "SaveOptions": {
    "SaveFormat": "pdf",
    "CompressionLevel": 9
  }
}

Réponse

L’API renvoie un objet SaveResponse.

{
  "Status": "OK",
  "Code": 200,
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  }
}

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 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éversé dépasse la taille maximale autorisée.
500	Erreur interne du serveur	Erreur serveur inattendue.

Comment utiliser l’API PostWorkbookSaveAs avec les SDK

Spécification de l’API PostWorkbookSaveAs

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

Vous pouvez utiliser cURL pour accéder facilement aux services web Aspose.Cells. L’exemple ci-dessous montre comment appeler l’API Cloud avec cURL.

Requête

curl -X POST "https://api.aspose.cloud/v3.0/cells/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" \
  -H "accept: multipart/form-data" \
  -H "Authorization: Bearer <your_jwt_token>"

Réponse

{
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Utiliser les SDK Aspose.Cells 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 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 :

Pour d’autres scénarios de conversion, consultez les guides Convertir Excel en PDF et Exporter Excel en CSV.

Convertir Excel en HTML Conversion avancée de fichier Excel