Ekstrak Lembar Kerja dari Excel

PDF4me Lembar Kerja Ekstrak adalah sebuah REST titik akhir yang mengambil lembar terpilih dari sebuah Excel buku kerja dan mengembalikannya sebagai konten buku kerja baru. POST berkas sebagai Base64 ke office/ApiV2Excel/ExcelExtractWorksheet, beri nama lembar kerja atau cantumkan indeks berbasis 0-nya, dan simpan hasil dekode. Jangan kirimkan selector apa pun dan semua lembar kerja akan diekstrak.

Fungsi dari endpoint ini

Memisahkan buku kerja berdasarkan lembar kerja. Anda mengirim seluruh file sekaligus dan menentukan lembar kerja mana yang Anda inginkan di dalamnya. ekstrakLembar KerjaKeTindakanExcel: berdasarkan nama tab yang tepat (sensitif terhadap huruf besar/kecil), berdasarkan indeks berbasis 0, atau keduanya sekaligus (gabungan akan digunakan). Ini menggantikan rutinitas klik kanan manual, Pindah atau Salin untuk distribusi laporan, pembagian per tim, dan alur kerja apa pun di mana penerima hanya boleh melihat lembar kerja mereka sendiri.

Postingan Blog Terkait

Belum ada postingan blog untuk fitur ini — akan segera hadir.

Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.

Kunjungi blog ini →

Memverifikasi Identitas Anda API Meminta

Setiap PDF4me REST panggilan harus menyertakan Anda API kunci di Authorization Header sebagai otentikasi Dasar. Dapatkan atau putar kunci Anda dari dasbor pengembang.

Get your API Key

Titik akhir

POSTkantor/ApiV2Excel/ExcelExtractWorksheet

Tukang Pos URLhttps://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet

Fakta Penting yang Tidak Boleh Anda Lewatkan

Nama + indeks = gabungan, tidak keduanya = segalanya

Menyediakan nama lembar kerja, Indeks lembar kerja, atau keduanya; lembar kerja apa pun yang cocok dengan salah satu daftar akan diekstrak. Hilangkan keduanya dan SEMUA lembar kerja akan diekstrak, yang jarang Anda inginkan untuk pemisahan yang ditargetkan.

Indeks berbasis 0, nama peka terhadap huruf besar dan kecil.

Indeks 0 adalah tab lembar kerja pertama. Nama yang berbeda dalam kapitalisasi dari tab sebenarnya tidak akan menghasilkan kecocokan apa pun, sehingga lembar kerja yang hilang secara tak terduga dalam output biasanya berarti ketidakcocokan huruf besar/kecil, bukan kesalahan penulisan. API kesalahan.

Kantor API keluarga, bentuk jalan yang berbeda

Excel operasi berlangsung di bawah kantor/ApiV2Excel/ pada host yang sama, bukan di bawah /api/v2/. Isi juga bersarang: sebuah objek aksi (ekstrakLembar KerjaKeTindakanExcel) sebagai pengganti bidang akar datar.

HTTP pengaturan

Metode: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
Tipe Konten: aplikasi/json
Authorization: Dasar <Anda PDF4me API kunci>

Jawabannya adalah... JSON: periksa success bendera, lalu Base64-mendekode konten buku kerja yang dikembalikan dan menyimpannya dengan sebuah .xlsx Ekstensi.

Lembar mana yang diekstrak: nama atau indeks?

Pemilihan bersifat deklaratif. Anda tidak pernah menyusun ulang atau melakukan perulangan; Anda mendeskripsikan lembar target sekali dan mesin akan menyelesaikannya terhadap buku kerja.

Nama vs indeks	Anda mengirim	Apa yang diekstrak
Hanya nama	`"worksheetNames": ["Sheet1", "Summary"]`	Lembar kerja yang nama tab-nya sama persis (sensitif terhadap huruf besar/kecil)
Hanya indeks	`"worksheetIndexes": [0, 2]`	Lembaran pada posisi berbasis 0 tersebut
Keduanya	nama + indeks	Gabungan: apa pun yang cocok dengan salah satu daftar tersebut
Juga tidak	`{}` objek aksi	Setiap lembar kerja dalam buku kerja

API bidang tubuh

Parameter	Diperlukan	Jenis	Apa fungsinya?	Contoh
`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`

Contoh muatan

Ekstrak dua lembar berdasarkan nama

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

Ekstrak berdasarkan indeks berbasis 0

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

Tips pengambilan oleh tukang pos

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.

contoh curl

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

Apa yang dimaksud dengan API kembali?

A JSON hasil yang menggambarkan ekstraksi dan membawa konten buku kerja baru sebagai Base64.

Bidang	Jenis	Isi di dalamnya
`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.

Contoh kode

Excel Perangkat ujung kantor belum tercakup oleh per-language folder sampel; repositori sampel membawa pola permintaan yang digunakan oleh setiap PDF4me keluarga titik akhir:

View API Samples Repository

Pertanyaan yang Sering Diajukan (FAQ)

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.

Mengapa mengekstrak lembar kerja melalui API alih-alih secara manual?

Rute manualnya adalah Pindahkan atau salin lembar kerja di ExcelKlik kanan tab, Pindah atau Salin, centang Buat salinan, simpan sebagai file baru, ulangi per lembar, per buku kerja, per siklus pelaporan. API Menggantikan perulangan tersebut dengan satu permintaan deterministik per pemisahan, yang Anda inginkan ketika buku kerja tiba sesuai jadwal dan pemisahan tersebut memberi makan sistem lain. Outputnya tetap standar. Kantor Buka XML buku kerja itu ExcelLibreOffice dan Google Sheets semuanya terbuka.