Estrai righe da Excel
PDF4me Estrai righe è un REST punto finale che legge le righe del foglio di lavoro da un Excel cartella di lavoro e li restituisce in formato strutturato JSON. POST il file .xlsx come Base64 A office/ApiV2Excel/ExcelExtractRows, definire l'ambito del foglio di lavoro e dell'intervallo di righe nell'oggetto azione e consumare il rowData Restituisce dati, non un file: document restituisce null.
Trasforma una porzione di foglio di lavoro in un JSON array: ogni riga diventa un oggetto in dati riga, pronto per un inserimento nel database, un API chiamata o un report. È la controparte di sola lettura di Aggiungi righe e Aggiorna righe e il API-equivalente laterale dell'esportazione Excel dati senza apertura ExcelNon viene prodotto alcun file modificato.
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/ExcelExtractRowsInformazioni importanti da non perdere
documento E fileName tornare nullo per impostazione predefinita; codice che si aspetta un Base64 Il file lì presente si romperà.HTTP impostare
Metodo: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows
Tipo di contenuto: applicazione/json
Authorization: Base <il tuo PDF4me API chiave>
La risposta è JSON: controlla il success bandiera, quindi itera il dati riga array. Non c'è alcun file da decodificare.
In che modo Extract Rows si differenzia dagli altri? Excel azioni di riga?
La famiglia di righe copre le operazioni di scrittura, sovrascrittura e lettura. Scegli in base a cosa deve accadere alla cartella di lavoro.
| Azione contro comportamento | Cosa fa alla cartella di lavoro | Ciò che ricevi indietro |
|---|---|---|
| Estrai righe (questo endpoint) | Niente, sola lettura | UN rowData JSON array, un oggetto per riga |
| Aggiungi righe | Aggiunge o inserisce nuove righe | La cartella di lavoro modificata come Base64 |
| Aggiorna righe | Sovrascrive i valori nelle righe esistenti | La cartella di lavoro modificata come Base64 |
| Elimina righe | Rimuove le righe | La cartella di lavoro modificata come Base64 |
API campi corporei
| Parametro | Necessario | Tipo | Cosa fa | Esempio |
|---|---|---|---|---|
document | Required | object | Document reference carrying Name, the Excel filename with its extension. | { "Name": "data.xlsx" } |
docContent | Required | string | Base64-encoded bytes of the workbook to read. | UEsDBBQABgAIAAAA... |
extractRowsToExcelAction | Required | object | Action configuration object. An empty object is valid and reads the default worksheet. | {} |
worksheetName | Optional | string | Inside the action object. Target worksheet by name. Names are matched exactly, so a typo silently misses the sheet. | Sheet1 |
worksheetIndex | Optional | number | Inside the action object. Target worksheet by position. The extraction engine counts 0-based, so 0 is the first sheet. | 0 |
fromRow / toRow | Optional | number | Inside the action object. Row range to extract. The engine counts rows 0-based with -1 meaning to the last data row, per the shared engine documented on the n8n Extract Rows action. | 0, -1 |
cultureName | Optional | string | Inside the action object. Culture used when serializing dates and numbers, for example en-US or de-DE. | en-US |
Esempi di carichi utili
Leggi il foglio di lavoro predefinito
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {}
}
Leggi un foglio di lavoro denominato con valori culturalmente sensibili
{
"document": { "Name": "sales.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {
"worksheetName": "Q3",
"cultureName": "en-US"
}
}
Consigli per la raccolta del postino
esempio di riccio
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"extractRowsToExcelAction": { "worksheetName": "Sheet1" }
}' \
--output response.json
Che cosa significa il API ritorno?
UN JSON risultato il cui payload è il rowData vettore.
| Campo | Tipo | Cosa contiene |
|---|---|---|
rowData | Array of objects | The primary output. Each entry is one extracted row as a JSON object, with column names or indexes as keys. |
success | Boolean | true when extraction succeeded. Check this before iterating rowData. |
document | null | Null for this endpoint: no modified file is produced. Present only because the office family shares one response shape. |
fileName | null | Null for this endpoint, for the same reason as document. |
errorMessage | String | Populated when success is false: a missing worksheet, invalid Base64, or a corrupted workbook. |
{
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{ "ColumnA": "value1", "ColumnB": "value2" },
{ "ColumnA": "value3", "ColumnB": "value4" }
]
}
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 Excel data via API invece che manualmente?
Il metodo manuale consiste nell'aprire la cartella di lavoro, selezionare l'intervallo, copiarlo da qualche parte e rimodellarlo manualmente, una volta per file, ad ogni aggiornamento. API legge le stesse righe di una richiesta deterministica e ti consegna JSON che qualsiasi language analizza in modo nativo, senza Excel installazione sul server. Poiché la sorgente rimane uno standard Ufficio aperto XML La cartella di lavoro e l'operazione sono di sola lettura, la stessa chiamata può essere eseguita in sicurezza in base a una pianificazione su file di produzione.