Fügen Sie eine Form mithilfe der Aspose.Cells Cloud-API in ein Excel-Arbeitsblatt ein
Diese REST-API fügt eine Form in ein Excel-Arbeitsblatt ein.
Der Endpunkt gehört zur API-Version v3.0. Stellen Sie sicher, dass Sie ein JWT-Zugriffstoken verwenden, das über den Aspose Cloud OAuth2-Flow (client-id/client-secret) erhalten wurde, und fügen Sie es in den Header Authorization: Bearer <token> ein.
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud-APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
PutWorksheetShape API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes
Anforderungsparameter
| Parametername | Typ | Speicherort | Beschreibung |
|---|---|---|---|
| name | string | path | Name des Dokuments. |
| sheetName | string | path | Name des Arbeitsblatts. |
| shapeDTO | object | body | JSON-Objekt, das die einzufügende Form beschreibt (siehe OpenAPI-Spezifikation für das vollständige Schema). |
| drawingType | string | query | Typ des Formobjekts (z. B. arc, line, rectangle). |
| upperLeftRow | integer | query | Zeilenindex der oberen linken Ecke der Form. |
| upperLeftColumn | integer | query | Spaltenindex der oberen linken Ecke der Form. |
| top | integer | query | Vertikaler Versatz der Form ab ihrem oberen Rand, in Pixel. |
| left | integer | query | Horizontaler Versatz der Form ab ihrem linken Rand, in Pixel. |
| width | integer | query | Breite der Form, in Pixel. |
| height | integer | query | Höhe der Form, in Pixel. |
| folder | string | query | Ordner, der das Dokument enthält. |
| storageName | string | query | Name des Speichers. |
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Sie können das cURL-Befehlszeilentool nutzen, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud-API mit cURL durchgeführt wird.
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. |
Typische Fehlerantworten umfassen:
- 400 Bad Request – fehlende oder ungültige Parameter.
- 401 Unauthorized – ungültiges oder fehlendes JWT-Token.
- 404 Not Found – das angegebene Arbeitsblatt oder Dokument ist nicht vorhanden.
Jeder Fehler wird als JSON-Objekt mit den Feldern Code und Message zurückgegeben.
Cloud SDK-Familie
Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details auf unterster Ebene, sodass Sie sich auf Ihre Projektaufgaben konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs anzuzeigen.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden: