Ajouter une image à une feuille de calcul Excel – Aspose.Cells Cloud API
Cette API REST ajoute une nouvelle image à une feuille de calcul Excel.
Prérequis : Vous devez posséder un jeton d’authentification Aspose Cloud valide, un classeur existant stocké dans un support pris en charge, ainsi que les autorisations appropriées pour modifier la feuille de calcul.
API PutWorksheetAddPicture
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
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 la requête
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | chemin | Nom du classeur. |
| sheetName | string | chemin | Nom de la feuille de calcul. |
| picture | object | corps | Objet image (données binaires). |
| upperLeftRow | integer | requête | Indice de ligne (à partir de zéro) du coin supérieur gauche où l’image sera placée. |
| upperLeftColumn | integer | requête | Indice de colonne (à partir de zéro) du coin supérieur gauche où l’image sera placée. |
| lowerRightRow | integer | requête | Indice de ligne (à partir de zéro) du coin inférieur droit de la zone d’image. |
| lowerRightColumn | integer | requête | Indice de colonne (à partir de zéro) du coin inférieur droit de la zone d’image. |
| picturePath | string | requête | Chemin vers le fichier image ; si omis, les données d’image doivent être fournies dans le corps de la requête. |
| folder | string | requête | Dossier contenant le classeur. |
| storageName | string | requête | Nom du service de stockage. |
Remarque concernant le corps de la requête : Lorsque picturePath est omis, envoyez les données binaires de l’image dans le corps de la requête en utilisant multipart/form-data.
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 | Requête incorrecte | 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 maximale autorisée. |
| 500 | Erreur interne du serveur | Erreur inattendue du serveur. |
Exemple de schéma de réponse 200
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
Remarque : La taille maximale autorisée pour une image est de 10 Mo ; les fichiers plus volumineux seront rejetés avec une réponse 400 Bad Request.
La Spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.
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 des appels à l’API Cloud à l’aide de cURL.
Famille de SDK Cloud
L’utilisation d’un SDK est le meilleur moyen 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 illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :
Remarque : Les formats d’image pris en charge incluent PNG, JPEG, BMP et GIF. La taille maximale autorisée pour une image est de 10 Mo ; les fichiers plus volumineux seront rejetés avec une réponse 400 Bad Request.