Sblocca Excel
PDF4me Sblocca Excel è un REST endpoint che rimuove la protezione tramite password da un Excel cartella di lavoro quando inserisci la password corretta. POST il file protetto come Base64 A office/ApiV2Excel/ExcelUnlock, inserisci la password all'interno unlockExcelActione salvare la copia decodificata non protetta da JSON risposta. Rimuove la protezione, ma non la incrina mai.
Prende una cartella di lavoro protetta e la relativa password e restituisce una copia non protetta. La crittografia dei file, la protezione della struttura della cartella di lavoro e i blocchi dei fogli di lavoro vengono rimossi in un'unica operazione, che è ciò di cui le pipeline automatizzate hanno bisogno prima di poter leggere le celle, aggiungere righe o unire file: ogni due Excel L'azione si aspetta una cartella di lavoro non protetta. La risposta è JSON con il risultato come Base64 contenuto.
Autenticazione del tuo API Richiesta
Ogni PDF4me REST la chiamata deve includere il tuo API chiave nel Authorization Intestazione come autenticazione di base. Ottieni o ruota la tua chiave dalla dashboard dello sviluppatore.
Punto finale
ufficio/ApiV2Excel/ExcelUnlockInformazioni importanti da non perdere
success: falso.password di sbloccoExcelAction Da una variabile d'ambiente o da un gestore di segreti, vale la stessa regola di qualsiasi credenziale.HTTP impostare
Metodo: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock
Tipo di contenuto: applicazione/json
Authorization: Base <il tuo PDF4me API chiave>
La risposta è JSON: controlla il success bandiera, poi Base64-decodifica il contenuto della cartella di lavoro restituita e salvalo con un .xlsx estensione.
Quali protezioni vengono rimosse sbloccando il sistema?
Excel La protezione è stratificata e ogni strato si comporta in modo diverso. Sbloccare il sistema con la password corretta rimuove tutti i livelli di protezione in un colpo solo.
| Protezione contro comportamento | Ciò che blocca | Rimosso da questo API |
|---|---|---|
| Crittografia dei file | Aprire il file senza la password | Sì, con la password corretta |
| Protezione della struttura della cartella di lavoro | Aggiungere, eliminare o riordinare i fogli | SÌ |
| Protezione del foglio di lavoro | Modifica delle celle su un foglio bloccato | SÌ |
| Una password sconosciuta e smarrita | Tutto quanto sopra | No. È necessaria la password corretta. |
API campi corporei
| Parametro | Necessario | Tipo | Cosa fa | Esempio |
|---|---|---|---|---|
document | Required | object | Document reference carrying Name, the protected Excel filename with its extension. | { "Name": "data.xlsx" } |
docContent | Required | string | Base64-encoded bytes of the password-protected workbook. | UEsDBBQABgAIAAAA... |
unlockExcelAction | Required | object | Action configuration object holding the password and optional culture settings. | { "password": "..." } |
password | Required | string | Inside the action object. The password that was used to protect the file. Inject from a secret store; never hardcode. | {{EXCEL_PASSWORD}} |
cultureName | Optional | string | Inside the action object. Culture code applied during processing. | en-US |
Esempi di carichi utili
Sblocca con una password segreta inserita
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}"
}
}
Sblocca con una cultura esplicita
{
"document": { "Name": "quarterly-report.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"unlockExcelAction": {
"password": "{{EXCEL_PASSWORD}}",
"cultureName": "en-US"
}
}
Consigli per la raccolta del postino
esempio di riccio
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"unlockExcelAction": {
"password": "'"$EXCEL_PASSWORD"'"
}
}' \
--output response.json
Che cosa significa il API ritorno?
UN JSON risultato che trasporta la cartella di lavoro non protetta come Base64.
| Campo | Tipo | Cosa contiene |
|---|---|---|
document | String (Base64) | The unprotected workbook content. Decode to bytes and save with an .xlsx extension. |
fileName | String | Output filename for the unlocked workbook. |
success | Boolean | true when unlocking succeeded. Check this before decoding content. |
errorMessage | String | Populated when success is false, including the wrong-password case. |
Esempi di codice
Excel Gli endpoint dell'ufficio non sono ancora coperti da per-language cartelle di esempio; il repository degli esempi contiene il modello di richiesta utilizzato da ogni PDF4me Famiglia di endpoint:
FAQ
Perché sbloccare tramite API invece che manualmente?
Il percorso manuale per un blocco a livello di foglio è deproteggendo il foglio in Excel: apri il file, inserisci la password, scheda Revisione, Rimuovi protezione foglio, salva, ripeti per ogni file. Questo non è scalabile per una cartella notturna di report protetti. API esegue la stessa rimozione verificata tramite password di una richiesta deterministica per file e l'output rimane uno standard Ufficio aperto XML Cartella di lavoro pronta per il resto del processo.