Estrai i fogli di lavoro da Excel
PDF4me Estrarre i fogli di lavoro è un REST punto finale che estrae i fogli selezionati da un Excel e li restituisce come nuovo contenuto della cartella di lavoro. POST il file come Base64 A office/ApiV2Excel/ExcelExtractWorksheetAssegna un nome ai fogli o elenca i loro indici a base 0 e salva il risultato decodificato. Non inviare alcun selettore e tutti i fogli di lavoro verranno estratti.
Divide una cartella di lavoro foglio per foglio. Invii l'intero file una sola volta e descrivi quali fogli vuoi includere. estraiFoglioDiLavoroInExcelAzione: tramite il nome esatto della scheda (sensibile alle maiuscole/minuscole), tramite indice basato su 0 o entrambi contemporaneamente (viene eseguita l'unione). Sostituisce la procedura manuale di clic destro, Sposta o Copia per la distribuzione dei report, le suddivisioni per team e qualsiasi flusso di lavoro in cui i destinatari devono visualizzare solo il proprio foglio.
Autenticazione del tuo API Richiesta
Ogni PDF4me REST la chiamata deve includere il tuo API chiave nel Authorization Intestazione come autenticazione di base. Ottieni o ruota la tua chiave dalla dashboard dello sviluppatore.
Punto finale
ufficio/ApiV2Excel/ExcelExtractWorksheetInformazioni importanti da non perdere
worksheetNames, Indici dei fogli di lavoroSe si selezionano entrambe le opzioni, vengono estratti tutti i fogli corrispondenti a uno dei due elenchi. Se si omettono entrambe, vengono estratti TUTTI i fogli di lavoro, il che raramente è ciò che si desidera per una divisione mirata.ufficio/ApiV2Excel/ sullo stesso host, non sotto /api/v2/. Il corpo è anche annidato: un oggetto azione (estraiFoglioDiLavoroInExcelAzione) invece di campi radice piatti.HTTP impostare
Metodo: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
Tipo di contenuto: applicazione/json
Authorization: Base <il tuo PDF4me API chiave>
La risposta è JSON: controlla il success bandiera, poi Base64-decodifica il contenuto della cartella di lavoro restituita e salvalo con un .xlsx estensione.
Quali fogli vengono estratti: i file dei nomi o gli indici?
La selezione è dichiarativa. Non è necessario riordinare o eseguire cicli; si descrivono i fogli di destinazione una sola volta e il motore li risolve confrontandoli con la cartella di lavoro.
| Nomi vs indici | Tu invii | Cosa viene estratto |
|---|---|---|
| Solo i nomi | "worksheetNames": ["Sheet1", "Summary"] | Fogli il cui nome della scheda corrisponde esattamente (sensibile alle maiuscole/minuscole) |
| Solo indici | "worksheetIndexes": [0, 2] | Fogli in quelle posizioni basate sullo 0 |
| Entrambi | nomi + indici | L'unione: qualsiasi cosa corrisponda a una delle due liste |
| Nessuno dei due | {} oggetto azione | Ogni foglio di lavoro nel quaderno di lavoro |
API campi corporei
| Parametro | Necessario | Tipo | Cosa fa | Esempio |
|---|---|---|---|---|
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 |
Esempi di carichi utili
Estrarre due fogli per nome
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Sheet1", "Summary"]
}
}
Estrazione tramite indice basato su 0
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetIndexes": [0, 2]
}
}
Consigli per la raccolta del postino
esempio di riccio
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
Che cosa significa il API ritorno?
UN JSON risultato che descrive l'estrazione e il trasporto del nuovo contenuto della cartella di lavoro come Base64.
| Campo | Tipo | Cosa contiene |
|---|---|---|
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. |
Esempi di codice
Excel Gli endpoint dell'ufficio non sono ancora coperti da per-language cartelle di esempio; il repository degli esempi contiene il modello di richiesta utilizzato da ogni PDF4me Famiglia di endpoint:
FAQ
Perché estrarre fogli di lavoro tramite API invece che manualmente?
Il percorso manuale è Sposta o copia i fogli di lavoro in Excel: fare clic con il pulsante destro del mouse sulla scheda, Sposta o copia, selezionare Crea una copia, salvare come nuovo file, ripetere per foglio, per cartella di lavoro, per ciclo di reporting. API sostituisce quel ciclo con una richiesta deterministica per ogni suddivisione, che è ciò che si desidera quando la cartella di lavoro arriva secondo una pianificazione e la suddivisione alimenta altri sistemi. L'output rimane standard Ufficio aperto XML cartella di lavoro che ExcelLibreOffice e Google Sheets si aprono tutti.