Proteggi un Workbook Excel usando l'API Aspose.Cells Cloud
Questa API REST protegge un workbook Excel, consentendoti di proteggere in modo sicuro un workbook Excel tramite password e opzioni di protezione utilizzando Aspose.Cells Cloud.
API PostProtectDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
Sicurezza e autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.
Parametri di Query
| Nome Parametro | Tipo | Descrizione |
|---|---|---|
| folder | string | Cartella contenente il workbook di origine. (opzionale) |
| storageName | string | Nome della posizione di archiviazione. (opzionale; default = “Default”) |
Parametri del Corpo della Richiesta
| Nome Parametro | Tipo | Descrizione |
|---|---|---|
| protection | WorkbookProtectionRequest | Oggetto che definisce le impostazioni di protezione per il workbook. |
WorkbookProtectionRequest
| Nome Parametro | Tipo | Descrizione |
|---|---|---|
| ProtectionType | string | Tipo di protezione da applicare. Valori ammessi (indipendenti dalla maiuscola/minuscola): ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS. |
| Password | string | Password opzionale da impostare per la protezione. |
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 Validata | Parametri mancanti o non validi (es. 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 PostProtectDocument con gli SDK
Prerequisiti
Prima di chiamare l’API, assicurati di aver completato i seguenti passaggi:
- Ottenere un token di accesso JWT seguendo il flusso di autenticazione descritto nella sezione sulla sicurezza.
- Caricare il workbook nella tua archiviazione Aspose Cloud o verificare che esso esista già nella cartella di destinazione.
- Conoscere il nome dell’archiviazione (il valore predefinito è
"Default"se non specificato) e il nome esatto del file che desideri proteggere.
Specifica dell’API PostProtectDocument
La Specifica OpenAPI definisce un’interfaccia di programmazione accessibile pubblicamente e consente di effettuare interazioni REST direttamente da un browser web.
Esempio: Proteggi un Workbook con cURL
-
Ottieni un token di accesso come descritto in Prerequisiti / Autenticazione.
-
Esegui la richiesta:
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'La risposta conterrà un oggetto di stato che conferma che la protezione è andata a buon fine.
Utilizzo degli SDK Aspose.Cells Cloud
L’utilizzo di un SDK rappresenta il modo più rapido per sviluppare con Aspose.Cells Cloud. Un SDK nasconde i dettagli di basso livello, consentendoti di concentrarti sulla logica di business. Consulta il repository GitHub per l’elenco completo degli SDK Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells utilizzando vari SDK:
Risposta Completa di Esempio
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}