Passa al contenuto principale

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.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog

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)

ParametroTipoDescrizioneEsempio
documento*ObjectRiferimento al documento con Nome Excel nome del file){ "Name": "data.xlsx" }
docContent*String Base64)Excel contenuto del documento codificato in Base64UEsDBBQABgAIAAAA...
secureExcelAction*ObjectConfigurazione delle azioni (password, livelli di protezione, selezione del foglio di lavoro)Vedi l'esempio di payload qui sotto

Parametri opzionali (all'interno di secureExcelAction)

ParametroTipoDescrizioneEsempio
passwordStringPassword 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
protectWorkbookBooleanAbilita la protezione della struttura della cartella di lavoro (Livello 2). Predefinito: falsotrue
proteggiPasswordCartellaDiLavoroStringPassword di protezione della cartella di lavoro. In alternativa: password se vuotaStructurePass
proteggiFogliDiLavoroBooleanAbilita la protezione del contenuto del foglio di lavoro (Livello 3). Predefinito: falsotrue
Tipo di protezione del foglio di lavoroStringContenuto, oggetti, Scenari, O TuttoPredefinito: TuttiAll
foglio di lavoroPassword di protezioneStringPassword di protezione del foglio di lavoro. In alternativa: password se vuotaEditPass
worksheetNamesStringNomi dei fogli di lavoro separati da virgole da proteggere; vuoto = tuttiSheet1,Summary
Indici dei fogli di lavoroStringIndici dei fogli di lavoro separati da virgola (base 0); vuoto = tutti0,2
Nome della culturaStringCodice culturale per l'elaborazioneen-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
}
}

Esempi di codice

Richiedi assistenza