Obtenir la description d'une ligne à partir d'une feuille de calcul Excel – API Aspose.Cells Cloud

Prérequis :

Obtenir un jeton d’accès JWT valide et l’inclure dans l’en-tête Authorization: Bearer <jeton JWT>.
Vérifier que le classeur est stocké dans le stockage Aspose Cloud ou spécifier le chemin du dossier où il se trouve.
Utiliser la version d’API v3.0, comme indiqué dans l’URL du point de terminaison.

Cette API REST permet de récupérer les données d’une ligne à partir de son index dans une feuille de calcul Excel.

API GetWorksheetRow

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

Sécurité et authentification

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	chemin	Nom du fichier de classeur.
sheetName	string	chemin	Nom de la feuille de calcul dans le classeur.
rowIndex	integer	chemin	Index de base zéro de la ligne à récupérer.
folder	string	requête	Dossier contenant le classeur.
storageName	string	requête	Nom du stockage dans lequel se trouve le classeur.

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 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 avec cURL. Inclure l’en-tête Authorization: Bearer <jeton JWT> pour authentifier la requête.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>"

Réponse

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Schéma de réponse

Propriété	Type	Description
`GroupLevel`	integer	Niveau de regroupement (outline level) de la ligne.
`Height`	number	Hauteur de la ligne en points.
`Index`	integer	Index de base zéro de la ligne retournée.
`IsBlank`	boolean	Indique si la ligne contient des données.
`IsHeightMatched`	boolean	`true` si la hauteur de la ligne correspond à la hauteur par défaut.
`IsHidden`	boolean	`true` si la ligne est masquée.
`Style`	object	Objet contenant les informations de style de la ligne.
`link`	object	Référence hypertexte vers la ressource ligne.
`Code`	integer	Code de statut HTTP de la réponse.
`Status`	string	Description textuelle du statut (par ex., « OK »).

Notes / Gestion des erreurs : L’API peut renvoyer les codes de statut HTTP suivants :

200 – Succès ; les données de la ligne sont retournées.
401 – Non autorisé ; le jeton JWT est manquant ou invalide.
404 – Introuvable ; le classeur, la feuille de calcul ou la ligne spécifiée n’existe pas.
500 – Erreur interne du serveur ; une condition inattendue s’est produite.

Code	Description	Remédiation
200	Succès – données de la ligne retournées.	–
401	Non autorisé – jeton JWT manquant ou invalide.	Fournir un jeton JWT valide.
404	Introuvable – classeur, feuille ou ligne absent.	Vérifier les noms et l’index de la ligne.
500	Erreur interne du serveur – condition inattendue.	Contacter le support Aspose.

Pour une liste complète des codes d’erreur, voir la documentation Aspose.Cells Cloud sur les codes d’erreur.

Famille de SDK Cloud

Utiliser un SDK est la méthode la plus rapide pour développer. Un SDK abstractise les détails de bas niveau afin que vous puissiez vous concentrer sur les tâches de votre projet. Consultez le dépôt GitHub pour une liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :