Lägg till vattenmärke i Excel-filer – Aspose.Cells Cloud-dokumentation

Detta REST API lägger till ett vattenmärke i Excel-filer.

Förutsättningar: Du måste skaffa en giltig JWT-åtkomsttoken och se till att Excel-filen är i ett format som stöds (t.ex. .xlsx, .xls).
Bakgrund: Ett vattenmärke är en halvtransparent textöverlagring som appliceras på varje kalkylblad för att indikera ägarskap eller sekretess.

PostWatermark API

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

Säkerhet och autentisering

Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.

Begärparametrar

Parameternamn	Typ	Plats	Beskrivning
`file`	fil	formData (multipart body)	Excel-filen som vattenmärket ska appliceras på.
`text`	sträng	query	Den text som ska visas som vattenmärke.
`color`	sträng	query	Vattenmärkets färg i ARGB-hexformat (t.ex. `004433ff`).

Svar

JSON-svaret innehåller en Files-array. För varje filobjekt:

Filename – namn på den bearbetade arbetsboken.
FileSize – filens storlek i byte.
FileContent – Base64-kodat innehåll i den vattenmärkta Excel-filen; avkoda denna för att få fram den faktiska filen.

{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[fil1-namn]",
            "Filesize" : [filstorlek],
            "FileContent" : "[Base64-sträng]"
        },
        {
            "Filename" : "[fil2-namn]",
            "Filesize" : [filstorlek],
            "FileContent" : "[Base64-sträng]"
        },
        {
            "Filename" : "[fil3-namn]",
            "Filesize" : [filstorlek],
            "FileContent" : "[Base64-sträng]"
        }
    ]
}

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Vattenmärket tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer.
400	Felaktig förfrågan	Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401	Inte auktoriserad	Ogiltig eller saknad JWT-token.
413	För stor nyttoinformation	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

Hur man använder PostWatermark API med SDK:er

PostWatermark API-specifikation

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda kommandoradsverktyget cURL för att anropa Aspose.Cells webbtjänster. Exemplet nedan visar en komplett begäran, inklusive den nödvändiga autentiseringshuvudet. Ersätt <your-jwt-token> med en giltig JWT-åtkomsttoken som du har erhållit från Asposes autentiseringsändpunkt.

Begäran

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"

Svar

{
  "Files": [
    {
      "Filename": "Sample_watermarked.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64-sträng--------"
    }
  ]
}

Använd Aspose.Cells Cloud SDK:er

Att använda ett SDK är det snabbaste sättet att utveckla på. Ett SDK abstraher bort detaljer på låg nivå och låter dig fokusera på din affärslogik. Kolla in GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur man anropar Aspose.Cells webbtjänster med olika SDK:er:

Lägg till bakgrundsbild i arbetsbok