Cifrar un libro de Excel con la API de Aspose.Cells Cloud – Ejemplos de cURL y SDK

Esta API REST cifra un libro de Excel.

Prerrequisitos: Debe poseer un token JWT válido y haber subido el libro a una ubicación de almacenamiento antes de llamar a este endpoint.

API PostEncryptDocument

POST https://api.aspose.cloud/v3.0/cells/{name}/encryption

Seguridad y autenticación

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

Parámetros de consulta

Nombre del parámetro	Tipo	Obligatorio	Descripción
folder	string	✗	Ruta de la carpeta donde se encuentra el libro original.
storageName	string	✗	Nombre del almacenamiento a utilizar.

Parámetro del cuerpo de la solicitud

Nombre del parámetro	Tipo	Obligatorio	Descripción
encryption	WorkbookEncryptionRequest	✓	Configuración de cifrado para el libro.

WorkbookEncryptionRequest

Nombre del parámetro	Tipo	Obligatorio	Descripción
EncryptionType	string	✓	Algoritmo de cifrado. Consulte la tabla siguiente para los valores admitidos y su significado.
KeyLength	integer	✗	Longitud de la clave de cifrado en bits (se ignora para `XOR` y `Compatible`).
Password	string	✓	Contraseña utilizada para el cifrado.

Valores de EncryptionType

Valor	Descripción
`XOR`	Algoritmo XOR simple (heredado, baja seguridad).
`Compatible`	Cifrado compatible con Excel 97‑2003 (40 bits).
`EnhancedCryptographicProviderV1`	AES‑128 con hash SHA‑1.
`StrongCryptographicProvider`	AES‑256 con hash SHA‑512 (el más seguro).

Respuesta

{
  "Status":"OK",
  "Code":200
}

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 inválidos (p. ej., tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o ausente.
413	Carga útil 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 PostEncryptDocument con SDK

Especificación de la API PostEncryptDocument

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

Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar una llamada a la API en la nube mediante cURL.

Solicitud

# Cifrar el libro "test.xlsx" utilizando el algoritmo XOR (clave de 128 bits) y la contraseña "mateen".
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/encryption" \
     -H "accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -d '{ "EncryptionType": "XOR", "KeyLength": 128, "Password": "mateen"}'

Respuesta

{
  "Code": "200",
  "Status": "OK"
}

Posibles respuestas de error

Estado HTTP	Código	Mensaje
400	BadRequest	Parámetros faltantes o inválidos.
401	Unauthorized	El token de autenticación no está presente o es inválido.
403	Forbidden	Permisos insuficientes para acceder al almacenamiento.
500	InternalServerError	Error inesperado en el servidor.

Utilizar los SDK de Aspose.Cells Cloud

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK maneja los detalles de bajo nivel, permitiéndole centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código muestran cómo llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Proteger un libro de Excel con la API de Aspose.Cells Cloud