Eliminar la protección por contraseña de Excel – Desbloquear contraseñas de apertura y modificación al instante
La API de desprotección de hojas de cálculo elimina la protección por contraseña de apertura y modificación de archivos de Excel en una sola llamada. Es ideal para canalizaciones de datos, sistemas de gestión de documentos y flujos de trabajo de migración.
API de desprotección de hojas de cálculo
API web
PUT https://api.aspose.cloud/v4.0/cells/unprotection/spreadsheet
Seguridad y autenticación
Las APIs de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
-H "Authorization: Bearer {access_token}"
Parámetros de solicitud
| Nombre del parámetro | Tipo | Ubicación | Descripción |
|---|---|---|---|
| Spreadsheet | File | FormData | El archivo de Excel que se va a desproteger. |
| password | String | Query | La contraseña que protege el archivo contra su apertura. |
| modifyPassword | String | Query | La contraseña necesaria para modificar el archivo (opcional si solo está establecida la contraseña de apertura). |
| outPath | String | Query | (Opcional) Ruta de carpeta donde se guardará la hoja de cálculo desprotegida. |
| outStorageName | String | Query | (Opcional) Nombre del almacenamiento donde se escribirá el archivo de salida. |
| region | String | Query | (Opcional) Configuración de región de la hoja de cálculo. |
Respuesta
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
]
Una respuesta correcta devuelve el archivo desprotegido como un flujo. El archivo puede guardarse en la ubicación especificada por outPath/outStorageName o recuperarse directamente desde la carga útil de la respuesta.
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK (Correcto) | 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 | Carga útil demasiado grande | El archivo subido supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
¿Cuándo debería utilizar la API de desprotección de hojas de cálculo?
- Recuperar el acceso a hojas de cálculo bloqueadas – Elimine rápidamente contraseñas de apertura o modificación olvidadas sin intervención manual.
- Automatizar el desbloqueo masivo – Procese grandes cantidades de archivos en proyectos de migración de datos o archivado.
- Integrar con flujos de trabajo existentes – Combine con APIs de almacenamiento o conversión para crear canalizaciones integrales (por ejemplo, subir → desproteger → convertir a PDF).
- Mantener la seguridad de los datos – La operación se realiza del lado del servidor, manteniendo los archivos originales seguros mientras la versión desprotegida se almacena en su almacenamiento en la nube.
Cómo utilizar la API de desprotección de hojas de cálculo con SDKs
Especificación OpenAPI
La especificación de la API de desprotección de hojas de cálculo proporciona una interfaz de programación accesible públicamente para facilitar interacciones REST directas 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 llamadas a la API en la nube con cURL.
Utilizar los SDKs de Aspose.Cells Cloud
El uso de un SDK simplifica la llamada al manejar la autenticación, la construcción de la solicitud y el análisis de la respuesta. Los SDKs están disponibles para muchos lenguajes e incluyen métodos listos para usar para desproteger hojas de cálculo.
Los siguientes ejemplos de código ilustran cómo llamar a la API de desprotección de hojas de cálculo mediante diversos SDKs: