Wasserzeichen zu Excel-Dateien hinzufügen – Aspose.Cells Cloud-Dokumentation

Diese REST-API fügt Wasserzeichen zu Excel-Dateien hinzu.

Voraussetzungen: Sie müssen ein gültiges JWT-Access-Token erhalten und sicherstellen, dass die Excel-Datei in einem unterstützten Format vorliegt (z. B. .xlsx, .xls).
Hintergrund: Ein Wasserzeichen ist ein halbtransparenter Textüberlagerung, der auf jeder Arbeitsmappe angezeigt wird, um den Besitz oder die Vertraulichkeit kenntlich zu machen.

PostWatermark API

POST https://api.aspose.cloud/v3.0/cells/watermark

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Speicherort	Beschreibung
`file`	file	formData (multipart body)	Die Excel-Datei, der das Wasserzeichen hinzugefügt werden soll.
`text`	string	query	Der anzuzeigende Wasserzeichen-Text.
`color`	string	query	Die Wasserzeichenfarbe im ARGB-Hex-Format (z. B. `004433ff`).

Antwort

Die JSON-Antwort enthält ein Files-Array. Für jedes Dateiobjekt:

Filename – Name der verarbeiteten Arbeitsmappe.
FileSize – Dateigröße in Byte.
FileContent – Base64-kodierter Inhalt der mit Wasserzeichen versehenen Excel-Datei; dekodieren Sie diesen, um die eigentliche Datei zu erhalten.

{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[Dateiname1]",
            "Filesize" : [Dateigröße],
            "FileContent" : "[Base64String]"
        },
        {
            "Filename" : "[Dateiname2]",
            "Filesize" : [Dateigröße],
            "FileContent" : "[Base64String]"
        },
        {
            "Filename" : "[Dateiname3]",
            "Filesize" : [Dateigröße],
            "FileContent" : "[Base64String]"
        }
    ]
}

HTTP-Statuscodes

Code	Bedeutung	Beschreibung
200	OK	Wasserzeichen 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.

Verwendung der PostWatermark API mit SDKs

PostWatermark API-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das Befehlszeilentool cURL verwenden, um Aspose.Cells-Webdienste aufzurufen. Das folgende Beispiel zeigt eine vollständige Anforderung einschließlich des erforderlichen Authentifizierungs-Headers. Ersetzen Sie <your-jwt-token> durch ein gültiges JWT-Access-Token, das Sie vom Aspose-Authentifizierungsendpunkt erhalten haben.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/watermark?text=aspose.cells.cloud&color=004433ff" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your-jwt-token>" \
  -F "file=@Sample.xlsx"

Antwort

{
  "Files": [
    {
      "Filename": "Sample_watermarked.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der schnellste Weg zur Entwicklung. Ein SDK abstrahiert Low-Level-Details, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können. Bitte besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden:

Hintergrundbild in Arbeitsmappe hinzufügen