Documentation – Récupérer une seule ligne d'une feuille Excel à l'aide de l'API Aspose.Cells Cloud

Developer-Guide: Obtenir la description d'une ligne à partir d'une feuille de calcul Excel

Mon, 01 Jan 0001 00:00:00 +0000

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 :

Developer-Guide: Obtenir des informations sur les lignes à partir d’une feuille Excel

Mon, 01 Jan 0001 00:00:00 +0000

Cet API REST permet de récupérer les informations sur les lignes d’une feuille Excel.

Conditions préalables
Pour appeler ce point de terminaison, vous devez fournir un jeton JWT valide dans l’en-tête Authorization. Ce jeton doit être obtenu via le mécanisme d’authentification Aspose.Cloud et inclure les étendues nécessaires pour les opérations sur les classeurs. L’API suit le schéma de gestion de version v3.0 et est soumise aux politiques standard de limitation de débit.

API GetWorksheetRows

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

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 classeur.
sheetName	string	path	Nom de la feuille de calcul.
folder	string	query	Dossier contenant le classeur.
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 ci-dessous montre comment effectuer des appels à l’API Cloud avec cURL.

Requête

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

Réponse

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Codes de réponse

Code	Signification	Description
200	OK	La requête a abouti et les informations sur les lignes sont renvoyées.
400	Requête incorrecte	La requête est mal formée (par exemple, des paramètres obligatoires sont manquants).
401	Non autorisé	Jeton JWT invalide ou manquant.
404	Non trouvé	Le classeur ou la feuille de calcul spécifié(s) n’existent pas.
500	Erreur interne du serveur	Une erreur inattendue s’est produite côté serveur.

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 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 ci-dessous montrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Requête

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Réponse

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

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 afin que vous puissiez vous concentrer sur les tâches de votre projet. Ci-dessous figurent des exemples de code spécifiques à chaque langage pour récupérer les lignes d’une feuille de calcul.