Agregar marca de agua a archivos de Excel – Documentación de Aspose.Cells Cloud

Esta API REST agrega una marca de agua a archivos de Excel.

Requisitos previos: Debe obtener un token de acceso JWT válido y asegurarse de que el archivo de Excel esté en un formato compatible (por ejemplo, .xlsx, .xls).
Antecedentes: Una marca de agua es una superposición de texto semitransparente aplicada a cada hoja de cálculo para indicar propiedad o confidencialidad.

API PostWatermark

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

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

Parámetros de solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
`file`	archivo	formData (cuerpo multipart)	El archivo de Excel al que se aplicará la marca de agua.
`text`	cadena	consulta	El texto de la marca de agua que se mostrará.
`color`	cadena	consulta	El color de la marca de agua en formato hexadecimal ARGB (por ejemplo, `004433ff`).

Respuesta

La respuesta JSON contiene un array Files. Para cada objeto de archivo:

Filename – nombre del libro de trabajo procesado.
FileSize – tamaño del archivo en bytes.
FileContent – contenido codificado en Base64 del archivo de Excel con marca de agua; decodifíquelo para obtener el archivo real.

{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[nombre_archivo1]",
            "Filesize" : [tamaño_archivo],
            "FileContent" : "[CadenaBase64]"
        },        {
            "Filename" : "[nombre_archivo2]",
            "Filesize" : [tamaño_archivo],
            "FileContent" : "[CadenaBase64]"
        },        {
            "Filename" : "[nombre_archivo3]",
            "Filesize" : [tamaño_archivo],
            "FileContent" : "[CadenaBase64]"
        }
    ]
}

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400	Solicitud incorrecta	Parámetros faltantes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o faltante.
413	Payload demasiado grande	El archivo subido excede el límite de tamaño.
500	Error interno del servidor	Error inesperado en el servidor.

Cómo usar la API PostWatermark con SDK

Especificación de la API PostWatermark

La Especificación OpenAPI define una interfaz de programación públicamente accesible y le permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para llamar a los servicios web de Aspose.Cells. El siguiente ejemplo muestra una solicitud completa, incluida la cabecera de autenticación requerida. Reemplace <your-jwt-token> por un token de acceso JWT válido obtenido del punto de conexión de autenticación de Aspose.

Solicitud

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"

Respuesta

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

Utilizar los SDK de Aspose.Cells Cloud

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK abstracta los detalles de bajo nivel, permitiéndole centrarse en la lógica de negocio. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código demuestran cómo invocar los servicios web de Aspose.Cells utilizando diversos SDK:

Agregar imagen de fondo a un libro de trabajo