Crittografare un libro Excel con l'API Aspose.Cells Cloud – Esempi cURL e SDK

Questa REST API crittografa un libro Excel.

Prerequisiti: È necessario disporre di un token JWT valido e del libro caricato in una posizione di archiviazione prima di chiamare questo endpoint.

API PostEncryptDocument

POST https://api.aspose.cloud/v3.0/cells/{name}/encryption

Sicurezza e autenticazione

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

Parametri della query

Nome Parametro	Tipo	Obbligatorio	Descrizione
folder	string	✗	Percorso della cartella del libro originale.
storageName	string	✗	Nome dell’archiviazione da utilizzare.

Parametro del corpo della richiesta

Nome Parametro	Tipo	Obbligatorio	Descrizione
encryption	WorkbookEncryptionRequest	✓	Impostazioni di crittografia del libro.

WorkbookEncryptionRequest

Nome Parametro	Tipo	Obbligatorio	Descrizione
EncryptionType	string	✓	Algoritmo di crittografia. Vedere la tabella sottostante per i valori supportati.
KeyLength	integer	✗	Lunghezza della chiave di crittografia in bit (ignorata per `XOR` e `Compatible`).
Password	string	✓	Password utilizzata per la crittografia.

Valori di EncryptionType

Valore	Descrizione
`XOR`	Algoritmo XOR semplice (obsoleto, bassa sicurezza).
`Compatible`	Crittografia compatibile con Excel 97‑2003 (40‑bit).
`EnhancedCryptographicProviderV1`	AES‑128 con hash SHA‑1.
`StrongCryptographicProvider`	AES‑256 con hash SHA‑512 (più sicura).

Risposta

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

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto del server.

Come utilizzare l’API PostEncryptDocument con gli SDK

Specifica dell’API PostEncryptDocument

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

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

# Crittografa il libro "test.xlsx" usando l'algoritmo XOR (chiave 128‑bit) e la password "mateen".
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/encryption" \
     -H "accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -d '{ "EncryptionType": "XOR", "KeyLength": 128, "Password": "mateen"}'

Risposta

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

Possibili risposte di errore

Stato HTTP	Codice	Messaggio
400	BadRequest	Parametri mancanti o non validi.
401	Unauthorized	Token di autenticazione assente o non valido.
403	Forbidden	Autorizzazioni insufficienti per accedere all’archiviazione.
500	InternalServerError	Errore imprevisto del server.

Utilizzare gli SDK Aspose.Cells Cloud

L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK Aspose.Cells Cloud.

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

Proteggi un Workbook Excel con l'API Aspose.Cells Cloud