Documento protetto - Excel API
PDF4me Proteggi Excel consente di applicare la protezione tramite password a Excel documenti a più livelli. Questo API Il servizio supporta la crittografia dei file (password per l'apertura), la protezione della struttura della cartella di lavoro (impedisce le modifiche ai fogli) e la protezione del contenuto dei fogli di lavoro (impedisce le modifiche alle celle), con una gerarchia di password flessibile e tipi di protezione (Contenuto, Oggetti, Scenari, Tutto). API riceve Excel contenuto del documento attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per la protezione dei dati riservati, la sicurezza dei modelli e i flussi di lavoro ad accesso controllato.
Autenticazione del tuo API Richiesta
Includi il tuo API chiave nella richiesta di autenticazione con il PDF4me REST API.
Caratteristiche principali
- Tre livelli di protezione: Crittografia dei file, struttura della cartella di lavoro, contenuto del foglio di lavoro
- Password indipendentiUtilizzare password diverse per ogni livello di protezione.
- Fallback della password: Utilizzare la password principale come password di riserva qualora non venga fornita la password specifica per il livello
- Selezione flessibile dei fogli di lavoro: Proteggere fogli di lavoro specifici o tutti i fogli di lavoro
- Opzioni relative al tipo di protezione: Contenuti, Oggetti, Scenari o Tutto (completo)
- Indicizzazione basata su 0Gli indici dei fogli di lavoro utilizzano una numerazione basata su 0 (0 = primo foglio di lavoro).
REST API Punto finale
- Metodo: POST
- Punto finale:
office/ApiV2Excel/ExcelSecure
REST API Parametri
Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. Tutte le richieste utilizzano documento, docContent, E secureExcelActionI parametri specifici dell'operazione (password, protectWorkbook, ecc.) sono proprietà dell'oggetto azione.
Parametri richiesti (livello radice)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| documento* | Object | Riferimento al documento con Nome Excel nome del file) | { "Name": "data.xlsx" } |
| docContent* | String Base64) | Excel contenuto del documento codificato in Base64 | UEsDBBQABgAIAAAA... |
| secureExcelAction* | Object | Configurazione delle azioni (password, livelli di protezione, selezione del foglio di lavoro) | Vedi l'esempio di payload qui sotto |
Parametri opzionali (all'interno di secureExcelAction)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| password | String | Password di crittografia del file (Livello 1). Utilizzata anche come soluzione di ripiego per la protezione di cartelle di lavoro/fogli di lavoro qualora le relative password siano vuote. | MyPassword123 |
| protectWorkbook | Boolean | Abilita la protezione della struttura della cartella di lavoro (Livello 2). Predefinito: falso | true |
| proteggiPasswordCartellaDiLavoro | String | Password di protezione della cartella di lavoro. In alternativa: password se vuota | StructurePass |
| proteggiFogliDiLavoro | Boolean | Abilita la protezione del contenuto del foglio di lavoro (Livello 3). Predefinito: falso | true |
| Tipo di protezione del foglio di lavoro | String | Contenuto, oggetti, Scenari, O TuttoPredefinito: Tutti | All |
| foglio di lavoroPassword di protezione | String | Password di protezione del foglio di lavoro. In alternativa: password se vuota | EditPass |
| worksheetNames | String | Nomi dei fogli di lavoro separati da virgole da proteggere; vuoto = tutti | Sheet1,Summary |
| Indici dei fogli di lavoro | String | Indici dei fogli di lavoro separati da virgola (base 0); vuoto = tutti | 0,2 |
| Nome della cultura | String | Codice culturale per l'elaborazione | en-US |
Produzione
IL API restituisce la password protetta Excel documento come Base64-stringa codificata in JSON formato (documento, nomefile, successo, messaggiodierrore).
Esempio di richiesta
Intestazione
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carico utile (base)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}