Why is this endpoint not under /api/v2/?

Excel operations belong to the PDF4me office API family, addressed as office/ApiV2Excel/ plus the action name on the same api.pdf4me.com host, with the same Basic Authorization header.

Entsperren Excel

PDF4me Entsperren Excel ist ein REST Endpunkt, der den Passwortschutz von einem entfernt Excel Arbeitsmappe, wenn Sie das richtige Passwort angeben. POST die geschützte Datei als Base64 Zu office/ApiV2Excel/ExcelUnlock, geben Sie das Passwort ein unlockExcelActionund speichern Sie die dekodierte, ungeschützte Kopie von der JSON Antwort. Es entfernt den Schutz; es bricht ihn niemals auf.

Was dieser Endpunkt bewirkt

Nimmt eine geschützte Arbeitsmappe samt Passwort und gibt eine ungeschützte Kopie zurück. Dateiverschlüsselung, Schutz der Arbeitsmappenstruktur und Tabellenblattsperren werden in einem Durchgang entfernt. Genau das benötigen automatisierte Prozesse, um Zellen zu lesen, Zeilen hinzuzufügen oder Dateien zusammenzuführen. Excel Die Aktion erwartet eine ungeschützte Arbeitsmappe. Die Antwort lautet: JSON mit dem Ergebnis Base64 Inhalt.

Verwandte Blog-Beiträge

Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.

Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.

Besuchen Sie den Blog →

Authentifizierung Ihres API Anfrage

Jeder PDF4me REST Der Anruf muss Ihre API Schlüssel im Authorization Header als Basic Auth. Ihren Schlüssel erhalten oder ändern Sie ihn im Entwickler-Dashboard.

Get your API Key

Endpunkt

POSToffice/ApiV2Excel/ExcelUnlock

Postbote URLhttps://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock

Wichtige Fakten, die Sie nicht verpassen sollten

Erfordert das korrekte Passwort. Kein Cracker.

Der API Der Schutz wird aufgehoben, sobald Sie das Passwort angeben, mit dem er angewendet wurde. Ein unbekanntes Passwort kann weder umgangen, wiederhergestellt noch per Brute-Force-Angriff geknackt werden; ein falsches Passwort führt zu einem Fehler. success: FALSCHDie

Das Passwort darf niemals fest im Payload codiert werden.

Anfragetexte landen in Skripten, Protokollen und der Versionskontrolle. Inject unlockExcelAction.password Für Anmeldeinformationen aus Umgebungsvariablen oder dem Secrets Manager gilt dieselbe Regel wie für alle anderen Anmeldeinformationen.

Erst entsperren, dann automatisieren

Andere Excel Aktionen (Zeilen hinzufügen, Arbeitsblätter extrahieren, Dateien zusammenführen) setzen eine ungeschützte Arbeitsmappe voraus. Verwenden Sie ExcelUnlock als ersten Schritt und leiten Sie dessen Ausgabe an die nachfolgenden Aktionen weiter.

HTTP aufstellen

Verfahren: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock
Inhaltstyp: application/json
Authorization: Basic <Ihre PDF4me API Schlüssel>

Die Antwort lautet: JSON: Überprüfen Sie die success Flagge, dann Base64-Dekodieren Sie den zurückgegebenen Arbeitsmappeninhalt und speichern Sie ihn mit einem .xlsx Verlängerung.

Welche Schutzmechanismen werden durch das Entsperren aufgehoben?

Excel Der Schutz ist mehrschichtig, und die einzelnen Schichten verhalten sich unterschiedlich. Durch das Entsperren mit dem richtigen Passwort werden alle Schichten auf einmal entfernt.

Schutz vs. Verhalten	Was es blockiert	Durch dieses entfernt API
Dateiverschlüsselung	Die Datei ohne Passwort überhaupt öffnen.	Ja, mit dem richtigen Passwort
Schutz der Arbeitsbuchstruktur	Hinzufügen, Löschen oder Neuanordnen von Blättern	Ja
Arbeitsblattschutz	Bearbeiten von Zellen auf einem gesperrten Tabellenblatt	Ja
Ein unbekanntes, verlorenes Passwort	Alles oben Genannte	Nein. Das richtige Passwort ist erforderlich.

API Körperfelder

Parameter	Erforderlich	Typ	Was es tut	Beispiel
`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`

Beispielnutzlasten

Entsperren Sie die Verbindung mit einem geheimen Passwort.

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "unlockExcelAction": {
 "password": "{{EXCEL_PASSWORD}}"
 }
}

Entfesseln Sie sich mit einer expliziten Kultur

{
 "document": { "Name": "quarterly-report.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "unlockExcelAction": {
 "password": "{{EXCEL_PASSWORD}}",
 "cultureName": "en-US"
 }
}

Tipps zur Postboten-Abholung

Headers

Content-Type: application/json + Authorization: Basic <apiKey>.

Body

raw JSON. The password goes INSIDE unlockExcelAction, not at the root. Use a Postman environment variable for it.

Response

JSON with a success flag and Base64 workbook content. Decode the content before saving as .xlsx.

Failures

A wrong password returns success false with an errorMessage; nothing is partially unlocked and the source is untouched.

curl-Beispiel

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

Was bedeutet das? API zurückkehren?

A JSON Ergebnis, das die ungeschützte Arbeitsmappe enthält Base64Die

Feld	Typ	Was es enthält
`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.

Codebeispiele

Excel Büroendpunkte sind noch nicht durch die pro-language Beispielordner; das Beispiel-Repository enthält das Anfragemuster, das von jedem verwendet wird PDF4me Endpunktfamilie:

View API Samples Repository

Häufig gestellte Fragen

Can this API unlock an Excel file without the password?+

No. The unlock action removes protection using the correct password you supply in unlockExcelAction.password. It is a workflow tool for files whose password you legitimately hold, not a password cracker or recovery service.

Which kinds of Excel protection does it remove?+

File encryption (the password prompt when opening), workbook structure protection, and worksheet protection are removed in one pass, returning a fully unprotected copy of the workbook.

Is the response the file itself?+

No. The API returns JSON containing the unlocked workbook as a Base64 string plus fileName, success, and errorMessage fields. Decode the content to bytes before saving as .xlsx.

What happens if I send the wrong password?+

The operation fails: success comes back false and errorMessage explains the failure. The workbook is never partially unlocked and your source file is never modified.

Does unlocking change the workbook contents?+

No. Cells, formulas, formatting, and sheets are untouched. Only the protection layers are removed; the output is the same workbook without the locks.

How do I keep the password out of my scripts?+

Inject it at runtime: a Postman environment variable, an environment variable in shell scripts, or a secrets manager in production code. Request bodies frequently end up in logs and version control, so treat the payload as sensitive.

Can I re-protect the file after processing?+

Yes. Chain the Secure Excel action after your processing steps to apply fresh protection to the finished workbook.

Warum entsperren über API statt manuell?

Die manuelle Vorgehensweise für eine Verriegelung auf Blechebene ist das Blatt vom Schutz befreien ExcelDatei öffnen, Passwort eingeben, Registerkarte „Überprüfen“, Blattschutz aufheben, speichern, für jede Datei wiederholen. Das ist nicht praktikabel für einen Ordner mit geschützten Berichten, der täglich aktualisiert wird. API Führt die gleiche passwortverifizierte Entfernung durch wie eine deterministische Anfrage pro Datei, und die Ausgabe bleibt ein Standard Büro geöffnet XML Die Arbeitsmappe ist bereit für den Rest des Produktionsprozesses.