Extrair planilhas de Excel
PDF4me Extrair Planilhas é um REST ponto final que extrai planilhas selecionadas de um Excel e os retorna como novo conteúdo da planilha. POST o arquivo como Base64 para office/ApiV2Excel/ExcelExtractWorksheet, nomeie as planilhas ou liste seus índices baseados em 0 e salve o resultado decodificado. Não envie nenhum seletor e todas as planilhas serão extraídas.
Divide uma planilha em folhas. Você envia o arquivo inteiro uma única vez e descreve quais folhas deseja incluir. ação de extrairplanilhaparaExcelA opção pode ser selecionada pelo nome exato da guia (respeitando maiúsculas e minúsculas), por índice baseado em zero ou por ambos simultaneamente (a união é considerada). Ela substitui a rotina manual de clicar com o botão direito do mouse e selecionar "Mover" ou "Copiar" para distribuição de relatórios, divisões por equipe e qualquer fluxo de trabalho em que os destinatários devam visualizar apenas a própria planilha.
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
office/ApiV2Excel/ExcelExtractWorksheetFatos importantes que você não deve perder
Nomes das planilhas, Índices da planilha, ou ambos; qualquer planilha que corresponda a qualquer uma das listas será extraída. Omita ambas e TODAS as planilhas serão extraídas, o que raramente é o desejado para uma divisão direcionada.escritório/ApiV2Excel/ no mesmo host, não sob /api/v2/O corpo também está aninhado: um objeto de ação (ação de extrairplanilhaparaExcel) em vez de campos raiz planos.HTTP configurar
Método: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
Tipo de conteúdo: aplicativo/json
Authorization: Básico <seu PDF4me API chave>
A resposta é JSON: verifique o success bandeira, então Base64-decodificar o conteúdo da planilha retornada e salvá-lo com um .xlsx extensão.
Quais planilhas são extraídas: nomes ou índices?
A seleção é declarativa. Você nunca reordena ou repete o processo; você descreve as planilhas de destino uma única vez e o mecanismo as resolve em relação à pasta de trabalho.
| Nomes versus índices | Você envia | O que é extraído? |
|---|---|---|
| Apenas nomes | "worksheetNames": ["Sheet1", "Summary"] | Planilhas cujo nome da guia corresponde exatamente (diferencia maiúsculas de minúsculas) |
| Apenas índices | "worksheetIndexes": [0, 2] | Folhas nessas posições de base 0 |
| Ambos | nomes + índices | A união: qualquer coisa que corresponda a qualquer uma das listas. |
| Nenhum | {} objeto de ação | Todas as folhas de exercícios do livro de atividades |
API campos corporais
| Parâmetro | Obrigatório | Tipo | O que faz | Exemplo |
|---|---|---|---|---|
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 |
Exemplos de cargas úteis
Extraia duas folhas pelo nome.
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Sheet1", "Summary"]
}
}
Extrair por índice baseado em 0
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetIndexes": [0, 2]
}
}
Dicas de coleta do carteiro
exemplo de 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
O que significa o API retornar?
A JSON resultado que descreve a extração e o transporte do novo conteúdo da planilha como Base64.
| Campo | Tipo | O que contém |
|---|---|---|
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. |
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 planilhas via API em vez de manualmente?
O percurso manual é Mova ou copie planilhas em ExcelClique com o botão direito do mouse na guia, selecione Mover ou Copiar, marque Criar uma cópia, salve como um novo arquivo e repita o processo para cada planilha, pasta de trabalho e ciclo de relatório. API Substitui esse loop por uma solicitação determinística por divisão, que é o ideal quando a planilha chega de acordo com um cronograma e a divisão alimenta outros sistemas. A saída permanece padrão. Escritório aberto XML caderno de exercícios que ExcelO LibreOffice e o Google Sheets estão todos abertos.