Extraer filas de Excel
PDF4me Extraer filas es un REST punto final que lee filas de la hoja de cálculo desde un Excel libro de trabajo y los devuelve como estructurados JSON. POST el .xlsx como Base64 a office/ApiV2Excel/ExcelExtractRows, delimitar el rango de la hoja de cálculo y de filas en el objeto de acción y consumir el rowData Matriz. Devuelve datos, no un archivo: document devuelve nulo.
Convierte una porción de hoja de cálculo en una JSON matriz: cada fila se convierte en un objeto en datos de fila, listo para una inserción en la base de datos, un API llamada o un informe. Es la contraparte de solo lectura de Agregar filas y Actualizar filas, y el API-equivalente lateral de exportación Excel datos sin abrir ExcelNo se genera ningún archivo modificado.
Autenticando su API Pedido
Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.
Punto final
Office/ApiV2Excel/ExtraerFilas de ExcelDatos importantes que no debes perderte
documento y fileName devolver nulo por diseño; código que espera un Base64 El archivo allí se romperá.HTTP configuración
Método: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>
La respuesta es JSON: comprobar el success bandera, luego iterar la datos de fila Matriz. No hay ningún archivo para decodificar.
¿En qué se diferencia Extraer filas de las demás? Excel ¿Acciones de fila?
La familia de filas abarca las operaciones de escritura, sobrescritura y lectura. Seleccione según lo que deba suceder con el libro de trabajo.
| Acción versus comportamiento | Qué efecto tiene en el libro de trabajo | Lo que recibes a cambio |
|---|---|---|
| Extraer filas (este punto final) | Nada, solo lectura | A rowData JSON matriz, un objeto por fila |
| Agregar filas | Agrega o inserta nuevas filas. | El libro de trabajo modificado como Base64 |
| Actualizar filas | Sobrescribe los valores de las filas existentes. | El libro de trabajo modificado como Base64 |
| Eliminar filas | Elimina filas | El libro de trabajo modificado como Base64 |
API campos corporales
| Parámetro | Requerido | Tipo | Lo que hace | Ejemplo |
|---|---|---|---|---|
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 |
Cargas útiles de ejemplo
Lea la hoja de cálculo predeterminada
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {}
}
Lee una hoja de trabajo con nombre y valores que tengan en cuenta la cultura.
{
"document": { "Name": "sales.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {
"worksheetName": "Q3",
"cultureName": "en-US"
}
}
Consejos para el cobro de carteros
Ejemplo de curl
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
¿Qué significa el API ¿devolver?
A JSON resultado cuya carga útil es la rowData matriz.
| Campo | Tipo | Lo que 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" }
]
}
Ejemplos de código
Excel Los puntos finales de la oficina aún no están cubiertos por per-language carpetas de muestra; el repositorio de muestras contiene el patrón de solicitud utilizado por cada PDF4me familia de puntos finales:
Preguntas frecuentes
¿Por qué extraer? Excel regalado API ¿En lugar de hacerlo manualmente?
La ruta manual consiste en abrir el libro de trabajo, seleccionar el rango, copiarlo en algún lugar y redimensionarlo manualmente, una vez por archivo, por cada actualización. API lee las mismas filas que una solicitud determinista y te entrega JSON que cualquier language analiza de forma nativa, sin Excel instalación en el servidor. Porque la fuente sigue siendo estándar Oficina abierta XML El libro de trabajo y la operación son de solo lectura, pero la misma llamada se puede ejecutar de forma segura según un cronograma en archivos en vivo.