Obtenir une forme par index dans une feuille Excel – Documentation Aspose.Cells Cloud
Cette API REST permet de récupérer une forme (y compris ses données d’image ou ses métadonnées) à partir d’une feuille Excel.
API GetWorksheetShape
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
Prérequis
- Un jeton d’accès Aspose Cloud valide (Bearer JWT).
- Le classeur doit être stocké dans votre espace de stockage Aspose Cloud ou dans un dossier spécifié.
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 la requête
| Nom du paramètre | Type | Emplacement | Description |
|---|---|---|---|
| name | string | path | Nom du fichier Excel. |
| sheetName | string | path | Nom de la feuille de calcul contenant la forme. |
| shapeindex | integer | path | Index de la forme dans la feuille (indexation à zéro). |
| folder | string | query | Chemin du dossier où le document est stocké. |
| storageName | string | query | Nom du service de stockage. |
Remarque : shapeindex est indexé à zéro ; la première forme a donc l’index 0. Assurez-vous que le classeur est stocké dans le dossier et le service de stockage spécifiés si vous n’utilisez pas le stockage par défaut.
La Spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer directement des interactions REST 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 ci-dessous montre comment effectuer un appel à l’API Cloud avec cURL.
Codes d’état HTTP possibles
| Code | Description |
|---|---|
| 200 OK | La forme a été récupérée avec succès. |
| 400 Bad Request | La requête est mal formée ou les paramètres obligatoires sont manquants. |
| 401 Unauthorized | L’authentification a échoué ou le jeton est manquant/ invalide. |
| 404 Not Found | Le classeur, la feuille ou l’index de forme spécifié n’existe pas. |
| 500 Internal Server Error | Une erreur inattendue s’est produite côté serveur. |
Précautions fréquentes : L’utilisation d’un domaine de base incorrect (api.aspose.com) ou du segment obsolète /autoshapes/ entraînera une erreur 404. Utilisez toujours le segment /shapes/ avec le domaine api.aspose.cloud.
Famille de SDK Cloud
L’utilisation d’un SDK est la meilleure façon d’accélérer le développement. Un SDK gère les détails de bas niveau et vous permet de vous concentrer sur les tâches de votre projet. 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 :
Pour les opérations associées, consultez la documentation sur Ajout d’une forme et Mise à jour d’une forme.