Arbeitsblattkommentar abrufen – Aspose.Cells Cloud API-Dokumentation
Diese REST-API ruft einen Arbeitsblattkommentar anhand des Zellnamens mithilfe von Aspose.Cells Cloud ab.
Voraussetzungen: Um diesen Vorgang aufzurufen, müssen Sie ein gültiges JWT-Zugriffstoken im Authorization-Header (Bearer <jwt token>) angeben. Tokens können über den in der Authentifizierungsanleitung beschriebenen Authentifizierungsfluss von Aspose.Cells Cloud abgerufen werden.
GetWorksheetComment API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/comments/{cellName}
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Position (URL-Pfad / Abfragezeichenfolge) | Beschreibung |
|---|---|---|---|
| name | string | URL-Pfad | Der Name der Excel-Datei. |
| sheetName | string | URL-Pfad | Der Name des Arbeitsblatts, das den Kommentar enthält. |
| cellName | string | URL-Pfad | Die Zelladresse (z. B. A1), deren Kommentar abgerufen werden soll. |
| folder | string | Abfragezeichenfolge | Der Ordnerpfad, in dem das Dokument gespeichert ist. |
| storageName | string | Abfragezeichenfolge | Der Name des Speicherdiensts. |
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud-API mit cURL durchgeführt wird.
Antwort: Die API gibt ein JSON-Objekt zurück, das ein Comment-Objekt mit den folgenden Feldern enthält:
| Feld | Typ | Beschreibung |
|---|---|---|
CellName |
string | Adresse der Zelle (z. B. A1). |
Author |
string | Name des Kommentarautors. |
HtmlNote |
string | Kommentarinhalt im HTML-Format (sofern vorhanden). |
Note |
string | Klartextversion des Kommentars. |
AutoSize |
boolean | Gibt an, ob die Kommentarbox automatisch skaliert wird. |
IsVisible |
boolean | Bestimmt, ob der Kommentar sichtbar ist. |
Width |
integer | Breite der Kommentarbox (in Zeichen). |
Height |
integer | Höhe der Kommentarbox (in Zeichen). |
TextHorizontalAlignment |
string | Horizontale Ausrichtung des Textes (z. B. Bottom). |
TextOrientationType |
string | Ausrichtung des Textes (z. B. TopToBottom). |
TextVerticalAlignment |
string | Vertikale Ausrichtung des Textes (z. B. Bottom). |
Häufige Fehler
- 401 Unauthorized – Stellen Sie sicher, dass das JWT-Token gültig, nicht abgelaufen und korrekt im
Authorization-Header platziert ist. - 404 Not Found – Überprüfen Sie, ob Dateiname, Arbeitsblattname und Zelladresse korrekt sind und ob die Datei im angegebenen Ordner/Speicher vorhanden ist.
- 500 Internal Server Error – Prüfen Sie die Anforderungsnutzdaten auf fehlerhafte Daten und bestätigen Sie, dass der Dienst ordnungsgemäß funktioniert.
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Details zum Vorgang. |
| 400 | Bad Request | Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp). |
| 401 | Unauthorized | Ungültiges oder fehlendes JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Cloud SDK-Familie
Die Verwendung eines SDKs ist der beste Weg, um die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details und ermöglicht es Ihnen, sich auf Ihre Projektaufgaben zu konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs anzuzeigen.
Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webservices mit verschiedenen SDKs durchgeführt werden: