Sicheres Dokument - Excel API
PDF4me Sicheres Excel ermöglicht es Ihnen, einen Passwortschutz anzuwenden Excel Dokumente auf mehreren Ebenen. Dies API Der Dienst unterstützt Dateiverschlüsselung (Passwort zum Öffnen), Schutz der Arbeitsmappenstruktur (Verhinderung von Blattänderungen) und Schutz des Arbeitsblattinhalts (Verhinderung von Zellenbearbeitungen) mit flexibler Passworthierarchie und Schutztypen (Inhalte, Objekte, Szenarien, Alle). API empfängt Excel Dokumentinhalt durch REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Diese Lösung eignet sich ideal für den Schutz vertraulicher Daten, die Sicherung von Vorlagen und Workflows mit kontrolliertem Zugriff.
Authentifizierung Ihres API Anfrage
Fügen Sie Ihre API Geben Sie den Schlüssel in der Anfrage ein, um sich mit dem zu authentifizieren. PDF4me REST APIDie
Hauptmerkmale
- Drei SchutzstufenDateiverschlüsselung, Arbeitsmappenstruktur, Arbeitsblattinhalt
- Unabhängige PasswörterVerwenden Sie für jede Schutzstufe unterschiedliche Passwörter.
- Passwort-Fallback: Verwende das Hauptpasswort als Ausweichpasswort, wenn kein stufenspezifisches Passwort angegeben wurde.
- Flexible Arbeitsblattauswahl: Bestimmte Arbeitsblätter oder alle Arbeitsblätter schützen
- Optionen für SchutzartenInhalte, Objekte, Szenarien oder Alles (umfassend)
- 0-basierte IndizierungDie Arbeitsblattindizes verwenden eine nullbasierte Nummerierung (0 = erstes Arbeitsblatt).
REST API Endpunkt
- Verfahren: POST
- Endpunkt:
office/ApiV2Excel/ExcelSecure
REST API Parameter
Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich. Alle Anfragen verwenden dokumentieren, docContent, Und sichereExcel-AktionOperationsspezifische Parameter (Passwort, protectWorkbook usw.) sind Eigenschaften des Aktionsobjekts.
Erforderliche Parameter (Stammebene)
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| dokumentieren* | Object | Dokumentenreferenz mit Name (Excel Dateiname) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel Dokumentinhalt kodiert in Base64 | UEsDBBQABgAIAAAA... |
| sichereExcel-Aktion* | Object | Aktionskonfiguration (Passwort, Schutzstufen, Arbeitsblattauswahl) | Siehe untenstehendes Nutzlastbeispiel. |
Optionale Parameter (innerhalb von secureExcelAction)
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| Passwort | String | Dateiverschlüsselungskennwort (Stufe 1). Wird auch als Ausweichkennwort für den Arbeitsmappen-/Arbeitsblattschutz verwendet, falls deren Kennwörter leer sind. | MyPassword123 |
| Arbeitsbuch schützen | Boolean | Arbeitsmappenstrukturschutz aktivieren (Stufe 2). Standard: deaktiviert | true |
| Arbeitsmappenpasswort schützen | String | Arbeitsmappenschutzkennwort. Ausweichkennwort: Kennwort, falls leer | StructurePass |
| Arbeitsblätter schützen | Boolean | Arbeitsblattschutz aktivieren (Stufe 3). Standard: deaktiviert | true |
| Arbeitsblattschutztyp | String | Inhalt, Objekte, Szenarien, oder AlleStandardeinstellung: Alle | All |
| Arbeitsblatt Schutzpasswort | String | Kennwort für den Arbeitsblattschutz. Ausweichkennwort: Kennwort, falls leer | EditPass |
| Arbeitsblattnamen | String | Durch Kommas getrennte Tabellennamen zum Schutz; leer = alle | Sheet1,Summary |
| Arbeitsblattindizes | String | Durch Kommas getrennte Tabellenblattindizes (0-basiert); leer = alle | 0,2 |
| Kulturname | String | Kulturcode für die Verarbeitung | en-US |
Ausgabe
Der API gibt das passwortgeschützte Excel Dokument als ein Base64-kodierte Zeichenkette in JSON Format (Dokument, Dateiname, Erfolg, Fehlermeldung).
Beispielanfrage
Kopfzeile
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Nutzlast (Basis)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}