Çalışma sayfalarını şuradan çıkarın: Excel

PDF4me Çıkarma Çalışma Sayfaları bir REST Seçilen sayfaları bir kaynaktan çeken uç nokta. Excel Çalışma kitabına ekler ve bunları yeni çalışma kitabı içeriği olarak geri gönderir. POST Dosya şu şekildedir: Base64 ile office/ApiV2Excel/ExcelExtractWorksheetSayfaları adlandırın veya 0 tabanlı indekslerini listeleyin ve çözümlenmiş sonucu kaydedin. Seçicilerden hiçbirini göndermeyin, böylece her çalışma sayfası ayıklanır.

Bu uç noktanın işlevi

Çalışma kitabını sayfa sayfa böler. Dosyanın tamamını bir kez gönderirsiniz ve hangi sayfaları istediğinizi belirtirsiniz. extractWorksheetToExcelAction: Tam sekme adına göre (büyük/küçük harf duyarlı), 0 tabanlı dizine göre veya her ikisine birden göre (birleşim alınır). Rapor dağıtımı, ekip bazında bölmeler ve alıcıların yalnızca kendi sayfalarını görmesi gereken herhangi bir iş akışı için manuel sağ tıklama, Taşı veya Kopyala rutinini değiştirir.

İ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/ExcelExtractWorksheet

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

Kaçırmamanız Gereken Önemli Bilgiler

İsimler + indeksler = birleşim, ne biri ne de diğeri = her şey

Sağlamak çalışma sayfası adları, çalışma sayfasıDizinlerYa da her ikisi birden; bu listelerden herhangi biriyle eşleşen tüm sayfalar ayıklanır. Her ikisini de atlarsanız, TÜM çalışma sayfaları ayıklanır ki bu, hedefli bir bölme için nadiren istediğiniz bir şeydir.

İndeksler 0 tabanlıdır, isimler büyük/küçük harf duyarlıdır.

İndeks 0, ilk sayfa sekmesidir. Gerçek sekmeden büyük/küçük harf farklılığı olan bir ad, sessizce hiçbir eşleşme sağlamaz; bu nedenle çıktıda beklenmedik bir şekilde eksik bir sayfa genellikle büyük/küçük harf uyumsuzluğu anlamına gelir, bir hata anlamına gelmez. API hata.

Ofis API aile, farklı yol şekli

Excel operasyonlar şu koşullar altında devam etmektedir: ofis/ApiV2Excel/ aynı sunucuda, onun altında değil. /api/v2/Gövde de iç içe geçmiş durumda: bir eylem nesnesi (extractWorksheetToExcelAction) düz kök alanları yerine.

HTTP kurmak

Yöntem: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
İç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.

Hangi sayfalar çıkarılacak: isimler mi yoksa indeksler mi?

Seçim bildirimseldir. Yeniden sıralama veya döngüye girme işlemi asla yapılmaz; hedef sayfaları bir kez tanımlarsınız ve motor bunları çalışma kitabına göre çözümler.

İsimler ve indeksler	Siz gönderiyorsunuz	Çıkarılan şey nedir?
Sadece isimler	`"worksheetNames": ["Sheet1", "Summary"]`	Sekme adı tam olarak eşleşen (büyük/küçük harf duyarlı) sayfalar
Yalnızca indeksler	`"worksheetIndexes": [0, 2]`	Sıfır tabanlı pozisyonlardaki sayfalar
İkisi birden	isimler + dizinler	Birlik: Her iki listeye de uyan herhangi bir şey
Hiç biri	`{}` eylem nesnesi	Çalışma kitabındaki her çalışma sayfası

API vücut alanları

Parametre	Gerekli	Tip	Ne işe yarar?	Örnek
`document`	Required	object	Document reference carrying Name, the source Excel filename with its extension.	`{ "Name": "data.xlsx" }`
`docContent`	Required	string	Base64-encoded bytes of the source workbook.	`UEsDBBQABgAIAAAA...`
`extractWorksheetToExcelAction`	Required	object	Action configuration object. Holds the worksheet selectors below; send it even when empty to extract all sheets.	`{ "worksheetNames": [...] }`
`worksheetNames`	Conditional	string[]	Inside the action object. Exact, case-sensitive sheet tab names to extract. Combine with indexes for a union.	`["Sheet1", "Summary"]`
`worksheetIndexes`	Conditional	int[]	Inside the action object. 0-based sheet positions to extract. Combine with names for a union.	`[0, 2]`
`cultureName`	Optional	string	Inside the action object. Culture code applied during processing.	`en-US`

Örnek yükler

İsimlerine göre iki sayfa çıkarın.

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "extractWorksheetToExcelAction": {
 "worksheetNames": ["Sheet1", "Summary"]
 }
}

0 tabanlı indekse göre çıkarım

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "extractWorksheetToExcelAction": {
 "worksheetIndexes": [0, 2]
 }
}

Postacı tahsilat ipuçları

Headers

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

Body

raw JSON. Note the nesting: selectors go INSIDE extractWorksheetToExcelAction, not at the root.

Response

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

Sheet names

Copy tab names from Excel exactly. Case matters, and a non-matching name is skipped silently rather than raising an error.

curl örneği

curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "document": { "Name": "data.xlsx" },
 "docContent": "'"$(base64 -w 0 data.xlsx)"'",
 "extractWorksheetToExcelAction": {
 "worksheetNames": ["Summary"]
 }
 }' \
 --output response.json

Ne anlama geliyor? API geri dönmek?

A JSON Çıkarma işlemini ve yeni çalışma kitabı içeriğinin taşınmasını açıklayan sonuç şu şekildedir: Base64.

Alan	Tip	İçeriğinde neler var?
`document / documents`	String (Base64) / Array	The extracted workbook content. A single extraction returns one document; multi-sheet extraction can return an array, so handle both shapes.
`fileName`	String	Output filename for the extracted workbook.
`success`	Boolean	true when extraction succeeded. Check this before decoding content.
`errorMessage`	String	Populated when success is false; explains what went wrong.

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

How do I extract a single sheet from an Excel workbook?+

Send the workbook as Base64 in docContent and put the sheet name in extractWorksheetToExcelAction.worksheetNames, for example ["Summary"]. The API returns a new workbook containing only that sheet.

What happens if I provide both worksheetNames and worksheetIndexes?+

The selections combine as a union: any sheet matching either a listed name or a listed index is extracted. If you provide neither field, every worksheet in the workbook is extracted.

Are worksheet indexes 0-based or 1-based?+

0-based. Index 0 is the first worksheet, index 1 the second, and so on. This matches the PDF4me Extract Worksheets documentation across platforms.

Are worksheet names case-sensitive?+

Yes. The name must match the sheet tab exactly, including case. A name that does not match any sheet is simply not extracted, so an unexpectedly missing sheet usually means a case mismatch rather than an API error.

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.

Does extraction change the source workbook?+

No. The source file you send is only read. The extracted sheets are returned as new workbook content in the response; nothing is written back to your original.

Can I extract every sheet into its own file?+

Sending an empty action object extracts all worksheets. For strict one-file-per-sheet splits, iterate your sheet list and call the endpoint once per name; each call returns a workbook containing just that sheet.

Çalışma sayfalarını neden şu yolla çıkarıyorsunuz? API manuel olarak yapmak yerine mi?

Manuel rota Çalışma sayfalarını taşıyın veya kopyalayın. ExcelSekmeye sağ tıklayın, Taşı veya Kopyala'yı seçin, Kopyasını oluştur'u işaretleyin, yeni bir dosya olarak kaydedin, bu işlemi her sayfa, her çalışma kitabı ve her raporlama döngüsü için tekrarlayın. API Bu işlem, her bölüm için tek bir belirleyici istekle o döngüyü değiştirir; bu da çalışma kitabının belirli bir program dahilinde geldiği ve bölümün diğer sistemlere veri sağladığı durumlarda istediğiniz şeydir. Çıktı standart kalır. Ofis Açık XML çalışma kitabı ExcelLibreOffice ve Google Sheets'in hepsi açık.