Agregar una firma digital a un libro de Excel – Aspose.Cells Cloud API

Requisitos previos:
Antes de llamar a este endpoint, asegúrese de tener:

Un token de acceso JWT válido obtenido mediante la autenticación de Aspose Cloud.
El libro de trabajo objetivo cargado en su almacenamiento de Aspose Cloud.
Un archivo de firma digital en formato .pfx o .p12 y su contraseña.

Esta API REST agrega una firma digital a un libro de Excel.

API PostDigitalSignature

POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature

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
name	string	`<code>path</code>`	Nombre del libro de trabajo.
digitalsignaturefile	string	`<code>query</code>`	Ruta al archivo de firma digital (`.pfx` o `.p12`).
password	string	`<code>query</code>`	Contraseña del libro de trabajo, si está protegido.
folder	string	`<code>query</code>`	Carpeta donde se almacena el libro de trabajo.
storageName	string	`<code>query</code>`	Nombre del servicio de almacenamiento a utilizar.

Nota: Si el nombre del archivo contiene caracteres especiales, realice su codificación URL antes de incluirlo en la cadena de consulta.

Manejo de errores

Estado HTTP	Significado
200	Firma aplicada correctamente.
400	Solicitud incorrecta: parámetros faltantes o no válidos.
401	No autorizado: token OAuth no válido o expirado.
403	Prohibido: permisos insuficientes o acceso denegado.
500	Error interno del servidor: fallo inesperado.

Respuestas de error por estado HTTPS

Estado HTTP	Código	Descripción
400	BadRequest	Parámetros faltantes o no válidos.
401	Unauthorized	Token de acceso no válido o faltante.
404	NotFound	Libro de trabajo especificado no encontrado en la carpeta/almacenamiento indicado.
500	InternalServerError	Error inesperado del servidor.

Cómo utilizar la API PostDigitalSignature con SDK

Especificación de la API PostDigitalSignature

La Especificación OpenAPI define una interfaz de programación públicamente accesible y 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 ejemplo siguiente muestra una solicitud a la API:

Solicitud

curl -v "https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature?digitalsignaturefile=signature.pfx&password=SuContraseña" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token jwt>"

Respuesta

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

Esquema de respuesta
La API devuelve un objeto JSON con los siguientes campos:

Campo	Tipo	Descripción
`Code`	int	Código de estado similar a HTTP que indica el resultado.
`Status`	string	Texto breve que describe el resultado (por ejemplo, `OK`).
`SignatureId`	string	Identificador de la firma digital aplicada (opcional).
`Message`	string	Información adicional o detalles de error (opcional).

Utilizar los SDK de Aspose.Cells Cloud

El uso de un SDK simplifica la integración y reduce el código repetitivo. 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 invocar los servicios web de Aspose.Cells mediante diversos SDK:

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