Bloquear archivos de Excel – Documentación de la API de Aspose.Cells Cloud

Versión de la API: v3.0 (actual)

Esta API REST bloquea libros de Excel.

API PostLock

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

Requisitos previos – La solicitud debe enviarse mediante HTTPS e incluir un token válido de OAuth 2.0 Bearer en el encabezado Authorization.

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
file	archivo	datos de formulario (cuerpo multipart)	El libro de Excel que se subirá y bloqueará.
password	string	cadena de consulta	Contraseña para el libro de trabajo (opcional).

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 acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo llamar a la API en la nube mediante cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

Respuesta

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Puede descargar un libro de ejemplo — Sample.xlsx — para probar la solicitud.

Nota: La API admite archivos de hasta 100 MB; cargas más grandes pueden provocar una respuesta 413 (Payload Too Large).

Detalles de la respuesta

Campo	Tipo	Descripción
Filename	string	Nombre del libro de trabajo bloqueado devuelto por el servicio.
FileSize	integer	Tamaño del archivo bloqueado en bytes.
FileContent	string (Base64)	El libro de trabajo bloqueado codificado como una cadena Base64.

Para recuperar el libro de trabajo bloqueado, decodifique el valor FileContent desde Base64 y guárdelo utilizando el Filename indicado en la respuesta.

Manejo de errores

– La API devuelve códigos de estado HTTP estándar (por ejemplo, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error) junto con un objeto JSON de error que contiene los campos Code y Message.

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK abstracta 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 realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK:

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Quitar protección de libro de Excel – Aspose.Cells Cloud API Modificar la protección por contraseña de un libro de Excel