Abrufen einer Form nach Index in einem Excel-Arbeitsblatt – Aspose.Cells Cloud-Dokumentation
Diese REST-API ruft eine Form (einschließlich ihrer Bilddaten oder Metadaten) aus einem Excel-Arbeitsblatt ab.
GetWorksheetShape API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
Voraussetzungen
- Ein gültiger Aspose Cloud-Zugriffstoken (Bearer JWT).
- Die Arbeitsmappe muss sich in Ihrem Aspose Cloud-Speicher oder in einem angegebenen Ordner befinden.
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud-APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Position | Beschreibung |
|---|---|---|---|
| name | string | path | Name des Excel-Dokuments. |
| sheetName | string | path | Name des Arbeitsblatts, das die Form enthält. |
| shapeindex | integer | path | Nullbasierter Index der Form innerhalb des Arbeitsblatts. |
| folder | string | query | Ordnerpfad, in dem das Dokument gespeichert ist. |
| storageName | string | query | Name des Speicherdiensts. |
Hinweis: shapeindex ist nullbasiert; die erste Form hat den Index 0. Stellen Sie sicher, dass die Arbeitsmappe im angegebenen folder und storageName gespeichert ist, sofern Sie nicht den Standardspeicher verwenden.
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 der Cloud-API mit cURL erfolgt.
Mögliche HTTP-Statuscodes
| Code | Beschreibung |
|---|---|
| 200 OK | Die Form wurde erfolgreich abgerufen. |
| 400 Bad Request | Die Anforderung ist fehlerhaft formatiert oder erforderliche Parameter fehlen. |
| 401 Unauthorized | Die Authentifizierung ist fehlgeschlagen oder das Token fehlt/ist ungültig. |
| 404 Not Found | Die angegebene Arbeitsmappe, das Arbeitsblatt oder der Formindex existiert nicht. |
| 500 Internal Server Error | Ein unerwarteter Serverfehler ist aufgetreten. |
Häufige Fehlerquellen: Die Verwendung einer falschen Basisdomain (api.aspose.com) oder des veralteten /autoshapes/-Pfads führt zu einem 404-Fehler. Verwenden Sie immer den /shapes/-Pfad mit der Domain api.aspose.cloud.
Cloud SDK-Familie
Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details der unteren Schicht und lässt Sie sich auf Ihre Projektziele konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mit verschiedenen SDKs aufgerufen werden:
Für verwandte Vorgänge siehe die Dokumentation zu Hinzufügen einer Form und Aktualisieren einer Form.