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.

Kilidi aç Excel

PDF4me Kilidi aç Excel bir REST parola korumasını kaldıran uç nokta Excel Doğru şifreyi girdiğinizde çalışma kitabı. POST korumalı dosya olarak Base64 ile office/ApiV2Excel/ExcelUnlockŞifreyi içeri koyun. unlockExcelActionve çözülmüş, korumasız kopyayı kaydedin. JSON Yanıt. Korumayı kaldırır; asla kırmaz.

Bu uç noktanın işlevi

Korumalı bir çalışma kitabını ve parolasını alır ve korumasız bir kopyasını döndürür. Dosya şifrelemesi, çalışma kitabı yapısı koruması ve çalışma sayfası kilitleri tek geçişte kaldırılır; bu da otomatikleştirilmiş işlem hatlarının hücreleri okuyabilmesi, satır ekleyebilmesi veya dosyaları birleştirebilmesi için gereken şeydir: her iki geçişte bir. Excel İşlem, korumasız bir çalışma kitabı bekliyor. Yanıt şu şekildedir: JSON sonuç olarak Base64 içerik.

İlgili Blog Yazıları

Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.

Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.

Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me REST Çağrınızda mutlaka sizin de bulunmanız gerekiyor. API anahtara girin Authorization Başlıkta Temel kimlik doğrulama (Basic auth) belirtilmiştir. Anahtarınızı geliştirici kontrol panelinden alın veya değiştirin.

Get your API Key

Uç nokta

POSTofis/ApiV2Excel/ExcelUnlock

Postacı URLhttps://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock

Kaçırmamanız Gereken Önemli Bilgiler

Doğru şifre gereklidir. Şifre kırıcı değildir.

O API Uygulama sırasında kullanılan parolayı girdiğinizde korumayı kaldırır. Bilinmeyen bir parolayı atlayamaz, kurtaramaz veya kaba kuvvet saldırısıyla kıramaz; yanlış parola girildiğinde ise eski sürüm geri döner. success: YANLIŞ.

Şifreyi asla doğrudan veri paketine yazmayın.

İstek gövdeleri komut dosyalarına, günlük dosyalarına ve sürüm kontrol sistemlerine kaydedilir. Inject ExcelAction.password'ün kilidini aç Ortam değişkeninden veya gizlilik yöneticisinden gelen bilgiler için de, diğer kimlik bilgileriyle aynı kural geçerlidir.

Önce kilidi açın, sonra otomatikleştirin.

Diğer Excel İşlemler (satır ekleme, çalışma sayfalarını ayıklama, dosyaları birleştirme) korumasız bir çalışma kitabı bekler. ExcelUnlock'u ilk adım olarak zincirleyin ve çıktısını sonraki aşamalara iletin.

HTTP kurmak

Yöntem: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelUnlock
İçerik Türü: uygulama/json
Authorization: Temel <sizin PDF4me API anahtar>

Yanıt şudur: JSON: kontrol edin success bayrak, sonra Base64-Döndürülen çalışma kitabının içeriğini çözün ve bir dosya ile kaydedin. .xlsx eklenti.

Kilidi açma işlemi hangi koruma önlemlerini kaldırır?

Excel Koruma katmanlıdır ve katmanlar farklı şekilde davranır. Doğru şifreyle kilidi açmak, tek seferde tüm koruma katmanlarını kaldırır.

Koruma ve davranış	Engellediği şey	Bu tarafından kaldırıldı API
Dosya şifreleme	Dosyayı şifre olmadan açmak mümkün değil.	Evet, doğru şifreyle.
Çalışma kitabı yapısı koruması	Sayfa ekleme, silme veya sayfaların sırasını değiştirme	Evet
Çalışma sayfası koruması	Kilitli sayfadaki hücreleri düzenleme	Evet
Bilinmeyen, kayıp bir şifre	Yukarıdakilerin hepsi	Hayır. Doğru şifre gereklidir.

API vücut alanları

Parametre	Gerekli	Tip	Ne işe yarar?	Örnek
`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`

Örnek yükler

Gizlice enjekte edilmiş bir parola ile kilidi açın.

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

Açık bir kültürle kilidi açın

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

Postacı tahsilat ipuçları

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 örneği

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

Ne anlama geliyor? API geri dönmek?

A JSON korumasız çalışma kitabını taşıyan sonuç Base64.

Alan	Tip	İçeriğinde neler var?
`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.

Kod örnekleri

Excel Ofis uç noktaları henüz kişi başı fiyatlandırma kapsamına alınmamıştır.language Örnek klasörler; örnekler deposu, her birinin kullandığı istek kalıbını içerir. PDF4me uç nokta ailesi:

View API Samples Repository

SSS

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.

Neden kilidi şu şekilde açabilirsiniz? API manuel olarak yapmak yerine mi?

Sac seviye kilidi için manuel yol şöyledir: çarşafın korumasını kaldırmak ExcelDosyayı açın, şifreyi girin, İnceleme sekmesine gidin, Sayfanın Korumasını Kaldır'ı seçin, kaydedin, her dosya için tekrarlayın. Bu, korumalı raporların bulunduğu gecelik bir klasör için ölçeklenebilir bir çözüm değil. API Dosya başına tek bir belirleyici istek gibi, parola doğrulamalı aynı kaldırma işlemini gerçekleştirir ve çıktı standart kalır. Ofis Açık XML Çalışma kitabı, işlem hattının geri kalanı için hazır.