Aggiungi una filigrana ai file Excel – Documentazione di Aspose.Cells Cloud

Questa API REST aggiunge una filigrana ai file Excel.

Prerequisiti: Devi ottenere un token di accesso JWT valido e assicurarti che il file Excel sia in un formato supportato (ad esempio, .xlsx, .xls).
Panoramica: Una filigrana è un sovraimpressione di testo semitrasparente applicata a ogni foglio di lavoro per indicare la proprietà o la riservatezza.

API PostWatermark

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
`file`	file	formData (corpo multipart)	Il file Excel a cui verrà applicata la filigrana.
`text`	string	query	Il testo della filigrana da visualizzare.
`color`	string	query	Il colore della filigrana in formato esadecimale ARGB (ad esempio, `004433ff`).

Risposta

La risposta JSON contiene un array Files. Per ogni oggetto file:

Filename – nome del foglio di calcolo elaborato.
FileSize – dimensione del file in byte.
FileContent – contenuto codificato in Base64 del file Excel con filigrana; decodificalo per ottenere il file effettivo.

{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[nome file1]",
            "Filesize" : [dimensione file],
            "FileContent" : "[StringaBase64]"
        },        {
            "Filename" : "[nome file2]",
            "Filesize" : [dimensione file],
            "FileContent" : "[StringaBase64]"
        },        {
            "Filename" : "[nome file3]",
            "Filesize" : [dimensione file],
            "FileContent" : "[StringaBase64]"
        }
    ]
}

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filigrana applicata con successo; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto nel server.

Come utilizzare l’API PostWatermark con gli SDK

Specifica dell’API PostWatermark

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per chiamare i servizi web di Aspose.Cells. L’esempio seguente mostra una richiesta completa, inclusa l’intestazione di autenticazione obbligatoria. Sostituisci <your-jwt-token> con un token di accesso JWT valido ottenuto dall’endpoint di autenticazione di Aspose.

Richiesta

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"

Risposta

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

Utilizzare gli SDK di Aspose.Cells Cloud

Utilizzare un SDK è il modo più rapido per sviluppare. Un SDK astrae i dettagli a basso livello, consentendoti di concentrarti sulla logica aziendale. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Aggiungi Immagine di Sfondo al Libro di Lavoro