Extrair linhas de Excel
PDF4me Extrair linhas é um REST ponto final que lê linhas da planilha de um Excel planilha e os retorna como estruturados JSON. POST o arquivo .xlsx como Base64 para office/ApiV2Excel/ExcelExtractRows, defina o escopo da planilha e do intervalo de linhas no objeto de ação e consuma o rowData array. Retorna dados, não um arquivo: document retorna nulo.
Transforma uma fatia de planilha em uma JSON matriz: cada linha se torna um objeto em dados_dados, pronto para uma inserção no banco de dados, um API chamada ou relatório. É a contraparte somente leitura de Adicionar Linhas e Atualizar Linhas, e do API-lado equivalente de exportar Excel dados sem abrir ExcelNenhum arquivo modificado foi gerado.
Autenticando seu API Solicitar
Todo PDF4me REST A chamada deve incluir o seu API chave no Authorization Defina o cabeçalho como autenticação básica. Obtenha ou altere sua chave no painel do desenvolvedor.
Ponto final
escritório/ApiV2Excel/ExcelExtrairLinhasFatos importantes que você não deve perder
documento e fileName retornar nulo por design; código que espera um Base64 O arquivo ali vai corromper.HTTP configurar
Método: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows
Tipo de conteúdo: aplicativo/json
Authorization: Básico <seu PDF4me API chave>
A resposta é JSON: verifique o success flag, depois itere o dados_dados matriz. Não há arquivo para decodificar.
Em que a função Extrair Linhas se diferencia das outras? Excel Ações da linha?
A família de linhas abrange as operações de escrever, sobrescrever e ler. Selecione de acordo com o que deve acontecer com a planilha.
| Ação versus comportamento | O que isso faz com o caderno de exercícios | O que você recebe de volta |
|---|---|---|
| Extrair linhas (este endpoint) | Nada, somente leitura | A rowData JSON matriz, um objeto por linha |
| Adicionar linhas | Acrescenta ou insere novas linhas. | A planilha modificada como Base64 |
| Atualizar linhas | Sobrescreve os valores nas linhas existentes. | A planilha modificada como Base64 |
| Excluir linhas | Remove linhas | A planilha modificada como Base64 |
API campos corporais
| Parâmetro | Obrigatório | Tipo | O que faz | Exemplo |
|---|---|---|---|---|
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 |
Exemplos de cargas úteis
Leia a planilha padrão
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {}
}
Leia uma folha de exercícios com o nome da instituição e valores que levem em consideração a cultura.
{
"document": { "Name": "sales.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {
"worksheetName": "Q3",
"cultureName": "en-US"
}
}
Dicas de coleta do carteiro
exemplo 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
O que significa o API retornar?
A JSON resultado cuja carga útil é o rowData variedade.
| Campo | Tipo | O que contém |
|---|---|---|
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" }
]
}
Exemplos de código
Excel Os endpoints de escritório ainda não são cobertos por per-language pastas de exemplo; o repositório de exemplos contém o padrão de requisição usado por todos. PDF4me família de endpoints:
Perguntas frequentes
Por que extrair? Excel dado API em vez de manualmente?
O método manual consiste em abrir a planilha, selecionar o intervalo, copiá-lo para algum lugar e redimensioná-lo manualmente, uma vez por arquivo, a cada atualização. API lê as mesmas linhas que uma solicitação determinística e te entrega. JSON que qualquer language analisa nativamente, sem Excel instalação no servidor. Porque a fonte permanece um padrão Escritório aberto XML Se a planilha e a operação forem somente leitura, a mesma chamada pode ser executada com segurança em um agendamento em arquivos ativos.