Rimuovi protezione password Excel – Sblocca password di apertura e modifica istantaneamente
L’API Unprotect Spreadsheet rimuove la protezione tramite password di apertura e modifica dai file Excel in una singola chiamata. È ideale per pipeline di dati, sistemi di gestione documentale e flussi di lavoro di migrazione.
API Unprotect Spreadsheet
API Web
PUT https://api.aspose.cloud/v4.0/cells/unprotection/spreadsheet
Sicurezza e autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
-H "Authorization: Bearer {access_token}"
Parametri della richiesta
| Nome parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| Spreadsheet | File | FormData | Il file Excel da sproteggere. |
| password | String | Query | La password che protegge il file contro l’apertura. |
| modifyPassword | String | Query | La password richiesta per modificare il file (opzionale se è impostata solo la password di apertura). |
| outPath | String | Query | (Opzionale) Percorso della cartella in cui verrà salvato il workbook sproteggiato. |
| outStorageName | String | Query | (Opzionale) Nome dello storage in cui verrà scritto il file di output. |
| region | String | Query | (Opzionale) Impostazioni della regione del foglio di calcolo. |
Risposta
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
]
Una risposta positiva restituisce il file sproteggiato come stream. Il file può essere salvato nella posizione specificata da outPath/outStorageName o recuperato direttamente dal payload della risposta.
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 sul server. |
Quando utilizzare l’API Unprotect Spreadsheet?
- Ripristinare l’accesso ai workbook protetti – Rimuovi rapidamente le password di apertura o modifica dimenticate senza intervento manuale.
- Automatizzare lo sblocco in blocco – Elabora un gran numero di file in progetti di migrazione dati o archiviazione.
- Integrare con flussi di lavoro esistenti – Combina con API di storage o conversione per creare pipeline end-to-end (ad esempio, caricamento → rimozione protezione → conversione in PDF).
- Mantenere la sicurezza dei dati – L’operazione avviene lato server, mantenendo i file originali sicuri mentre la versione sproteggiata viene archiviata nel tuo storage cloud.
Come utilizzare l’API Unprotect Spreadsheet con gli SDK
Specifica OpenAPI
La Specifica API UnProtect Spreadsheet fornisce un’interfaccia di programmazione accessibile pubblicamente per facilitare interazioni REST dirette da un browser web.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. Il seguente esempio mostra come effettuare chiamate all’API Cloud con cURL.
Utilizzare gli SDK Aspose.Cells Cloud
L’utilizzo di un SDK semplifica la chiamata gestendo l’autenticazione, la costruzione della richiesta e l’analisi della risposta. Gli SDK sono disponibili per molte linguaggi e includono metodi già pronti per la rimozione della protezione dai fogli di calcolo.
I seguenti esempi di codice illustrano come chiamare l’API Unprotect Spreadsheet utilizzando vari SDK: