Aggiungi una firma digitale a un libro Excel – Aspose.Cells Cloud API

Prerequisiti:
Prima di chiamare questo endpoint, assicurati di disporre di:

Un token di accesso JWT valido ottenuto tramite l’autenticazione di Aspose Cloud.
Il libro di destinazione caricato nello storage di Aspose Cloud.
Un file di firma digitale in formato .pfx o .p12 e la relativa password.

Questa API REST aggiunge una firma digitale a un libro Excel.

API PostDigitalSignature

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome del parametro	Tipo	Posizione	Descrizione
name	string	`<code>path</code>`	Nome del libro.
digitalsignaturefile	string	`<code>query</code>`	Percorso del file di firma digitale (`.pfx` o `.p12`).
password	string	`<code>query</code>`	Password del libro, se protetto.
folder	string	`<code>query</code>`	Cartella in cui è memorizzato il libro.
storageName	string	`<code>query</code>`	Nome del servizio di storage da utilizzare.

Nota: Se il nome del file contiene caratteri speciali, effettua l’URL encoding prima di aggiungerlo alla stringa di query.

Gestione degli errori

Stato HTTP	Significato
200	Firma applicata con successo.
400	Richiesta non valida – parametri mancanti o non validi.
401	Non autorizzato – token OAuth non valido o scaduto.
403	Accesso negato – autorizzazioni insufficienti.
500	Errore interno del server – errore imprevisto.

Risposte di errore con codice HTTP

Stato HTTP	Codice	Descrizione
400	BadRequest	Parametri mancanti o non validi.
401	Unauthorized	Token di accesso non valido o mancante.
404	NotFound	Libro specificato non trovato nella cartella/storage indicata.
500	InternalServerError	Errore imprevisto del server.

Come utilizzare l’API PostDigitalSignature con gli SDK

Specifica dell’API PostDigitalSignature

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per chiamare i servizi web di Aspose.Cells. L’esempio riportato di seguito mostra una richiesta all’API:

Richiesta

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

Risposta

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

Schema della risposta
L’API restituisce un oggetto JSON con i seguenti campi:

Campo	Tipo	Descrizione
`Code`	int	Codice di stato simile a HTTP che indica il risultato.
`Status`	string	Testo breve che descrive l’esito (ad esempio, `OK`).
`SignatureId`	string	Identificativo della firma digitale applicata (opzionale).
`Message`	string	Informazioni aggiuntive o dettagli sull’errore (opzionale).

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK semplifica l’integrazione e riduce il codice ripetitivo. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Proteggi file Excel