Proteger un libro de Excel utilizando la API de Aspose.Cells Cloud
Esta API REST protege un libro de Excel, permitiéndole proteger de forma segura un libro de Excel con contraseña y opciones de protección mediante Aspose.Cells Cloud.
API PostProtectDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
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 | Descripción |
|---|---|---|
| folder | string | Carpeta que contiene el libro de origen. (opcional) |
| storageName | string | Nombre de la ubicación del almacenamiento. (opcional; predeterminado = “Default”) |
Parámetros del cuerpo de la solicitud
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| protection | WorkbookProtectionRequest | Objeto que define la configuración de protección para el libro. |
WorkbookProtectionRequest
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| ProtectionType | string | Tipo de protección a aplicar. Valores permitidos (no sensibles a mayúsculas/minúsculas): ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS. |
| Password | string | Contraseña opcional para establecer en la protección. |
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 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 supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Cómo usar la API PostProtectDocument con SDK
Requisitos previos
Antes de llamar a la API, asegúrese de haber completado los siguientes pasos:
- Obtener un token de acceso JWT mediante el flujo de autenticación descrito en la sección de seguridad.
- Subir el libro de Excel a su almacenamiento de Aspose Cloud o confirmar que ya existe en la carpeta de destino.
- Conocer el nombre del almacenamiento (predeterminado es
"Default"si no se especifica) y el nombre exacto del archivo que desea proteger.
Especificación de la API PostProtectDocument
La Especificación OpenAPI define una interfaz de programación públicamente accesible y le permite realizar interacciones REST directamente desde un navegador web.
Ejemplo: Proteger un libro con cURL
-
Obtenga un token de acceso según se describe en Requisitos previos / Autenticación.
-
Ejecute la solicitud:
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'La respuesta incluirá un objeto de estado que confirma que la protección se realizó correctamente.
Utilizar los SDK de Aspose.Cells Cloud
Utilizar un SDK es la forma más rápida de desarrollar con Aspose.Cells Cloud. Un SDK abstracta los detalles de bajo nivel, permitiéndole centrarse en su lógica de negocio. Consulte el repositorio de GitHub para ver 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 utilizando diversos SDK:
Respuesta completa de ejemplo
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}