Obtenir un commentaire de feuille de calcul – Documentation de l’API Aspose.Cells Cloud

Cette API REST permet de récupérer un commentaire de feuille de calcul par nom de cellule à l’aide de Aspose.Cells Cloud.

Prérequis : Pour appeler cette opération, vous devez inclure un jeton d’accès JWT valide dans l’en-tête Authorization (Bearer <jeton jwt>). Les jetons peuvent être obtenus via le flux d’authentification d’Aspose.Cells Cloud décrit dans le guide d’authentification.

API GetWorksheetComment

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

Sécurité et authentification

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement (chemin URL / chaîne de requête)	Description
name	string	Chemin URL	Le nom du fichier Excel.
sheetName	string	Chemin URL	Le nom de la feuille de calcul contenant le commentaire.
cellName	string	Chemin URL	L’adresse de la cellule (par exemple, A1) dont le commentaire est récupéré.
folder	string	Chaîne de requête	Le chemin du dossier dans lequel le document est stocké.
storageName	string	Chaîne de requête	Le nom du service de stockage.

La spécification OpenAPI définit une interface de programmation accessible publiquement et vous 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 à l’API Cloud avec cURL.

Requête

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

Réponse

{
  "Comment": {
    "CellName": "A1",
    "Author": "roy.wang",
    "HtmlNote": "",
    "Note": "Aspose.Cells Cloud.",
    "AutoSize": "True",
    "IsVisible": "True",
    "Width": 30,
    "Height": 10,
    "TextHorizontalAlignment": "Bottom",
    "TextOrientationType": "TopToBottom",
    "TextVerticalAlignment": "Bottom"
  },
  "Code": 200,
  "Status": "OK"
}

Réponse : L’API renvoie un objet JSON contenant un objet Comment comportant les champs suivants :

Champ	Type	Description
`CellName`	string	Adresse de la cellule (par exemple, A1).
`Author`	string	Nom de l’auteur du commentaire.
`HtmlNote`	string	Contenu du commentaire au format HTML (le cas échéant).
`Note`	string	Version texte brut du commentaire.
`AutoSize`	boolean	Indique si la boîte de commentaire s’ajuste automatiquement.
`IsVisible`	boolean	Détermine si le commentaire est visible.
`Width`	integer	Largeur de la boîte de commentaire (en caractères).
`Height`	integer	Hauteur de la boîte de commentaire (en caractères).
`TextHorizontalAlignment`	string	Alignement horizontal du texte (par exemple, Bottom).
`TextOrientationType`	string	Orientation du texte (par exemple, TopToBottom).
`TextVerticalAlignment`	string	Alignement vertical du texte (par exemple, Bottom).

Erreurs courantes

401 Non autorisé – Vérifiez que le jeton JWT est valide, non expiré et correctement placé dans l’en-tête Authorization.
404 Non trouvé – Assurez-vous que le nom du fichier, le nom de la feuille de calcul et l’adresse de la cellule sont corrects, et que le fichier existe dans le dossier/le stockage spécifié.
500 Erreur interne du serveur – Vérifiez la charge utile de la requête pour les données mal formées et confirmez que le service est opérationnel.

Codes d’état 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 non valides (par exemple, type de fichier non pris en charge).
401	Non autorisé	Jeton JWT non valide ou manquant.
413	Charge utile trop grande	Fichier téléchargé dépassant la limite de taille.
500	Erreur interne du serveur	Erreur inattendue du serveur.

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 et vous permet de 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 suivants illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

API de suppression de commentaire de feuille de calcul – Aspose.Cells Cloud Ajouter un commentaire de feuille de calcul