Ajouter une forme à une feuille Excel à l’aide de l’API Aspose.Cells Cloud
Cette API REST permet d’ajouter une forme à une feuille Excel.
Le point de terminaison appartient à la version de l’API v3.0 ; veillez à utiliser un jeton d’accès JWT obtenu via le flux OAuth2 Aspose Cloud (client‑id/client‑secret) et à l’inclure dans l’en‑tête Authorization: Bearer <token>.
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.
API PutWorksheetShape
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes
Paramètres de la requête
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | path | Nom du document. |
| sheetName | string | path | Nom de la feuille de calcul. |
| shapeDTO | object | body | Objet JSON décrivant la forme à ajouter (voir la spécification OpenAPI pour le schéma complet). |
| drawingType | string | query | Type d’objet forme (par exemple, arc, line, rectangle). |
| upperLeftRow | integer | query | Index de ligne supérieure gauche de la forme. |
| upperLeftColumn | integer | query | Index de colonne supérieure gauche de la forme. |
| top | integer | query | Décalage vertical de la forme depuis son bord supérieur, en pixels. |
| left | integer | query | Décalage horizontal de la forme depuis son bord gauche, en pixels. |
| width | integer | query | Largeur de la forme, en pixels. |
| height | integer | query | Hauteur de la forme, en pixels. |
| folder | string | query | Dossier contenant le document. |
| storageName | string | query | Nom du stockage. |
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 un appel vers l’API Cloud avec cURL.
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échargé dépasse la limite de taille. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Les réponses d’erreur typiques incluent :
- 400 Mauvaise requête – paramètres manquants ou invalides.
- 401 Non autorisé – jeton JWT invalide ou manquant.
- 404 Non trouvé – la feuille de calcul ou le document spécifié n’existe pas.
Chaque erreur est renvoyée sous forme d’objet JSON contenant les champs Code et Message.
Famille de SDK 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 Cloud Aspose.Cells.
Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :