Récupérer les noms d'un classeur Excel – Aspose.Cells Cloud API

Cette API REST permet de récupérer les noms définis dans un classeur Excel.

Sécurité et authentification

Les API Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.

API GetWorkbookNames

GET https://api.aspose.cloud/v3.0/cells/{name}/names

Les paramètres de la requête sont les suivants :

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du fichier classeur.
folder	string	query	Dossier contenant le classeur.
storageName	string	query	Nom du stockage à utiliser.

La requête doit inclure les en-têtes HTTP suivants :

En-tête	Type	Description
Authorization	string	Jeton bearer JWT (obligatoire)
Accept	string	`application/json`
Content-Type	string	`application/json` (pour les requêtes contenant un corps)

Authentification – L’API exige un jeton bearer OAuth2/JWT. Obtenez un jeton à partir de https://api.aspose.cloud/connect/token à l’aide de votre client-id et client-secret, puis incluez l’en-tête Authorization: Bearer <jeton jwt> dans chaque requête.

La spécification OpenAPI définit une interface de programmation accessible publiquement 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 aux services web Aspose.Cells. L’exemple ci-dessous montre comment appeler l’API Aspose.Cells Cloud à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/names" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Réponse

{
  "Status": "chaîne de caractères",
  "Names": {
    "link": {
      "Href": "chaîne de caractères",
      "Rel": "chaîne de caractères",
      "Title": "chaîne de caractères",
      "Type": "chaîne de caractères"
    },
    "Count": 0,
    "NameList": [
      {
        "link": {
          "Href": "chaîne de caractères",
          "Rel": "chaîne de caractères",
          "Title": "chaîne de caractères",
          "Type": "chaîne de caractères"
        }
      }
    ]
  }
}

Champs de la réponse

Status (string) – Message indiquant le statut de l’opération.
Names.link (object) – Informations d’hyperlien concernant la collection.
Names.Count (integer) – Nombre total de noms définis retournés.
Names.NameList (array) – Liste des objets nom ; chaque objet contient un objet link avec les détails de navigation.

Gestion des erreurs – Le service peut renvoyer les codes de statut HTTP suivants :

Code	Signification	Action recommandée
401	Non autorisé	Vérifiez qu’un jeton JWT valide est fourni.
404	Introuvable	Vérifiez que le nom du classeur, le dossier et le stockage sont corrects.
500	Erreur interne du serveur	Réessayez ultérieurement ou contactez le support Aspose si le problème persiste.

Famille de SDK Cloud

L’utilisation d’un SDK constitue la méthode la plus rapide pour développer. Un SDK gère les détails de bas niveau, vous permettant ainsi de vous concentrer sur 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 :

Ajuster automatiquement les lignes dans un classeur Excel Calculer toutes les formules d’un classeur Excel