Extraire les feuilles de travail de Excel
PDF4me Extraire les feuilles de travail est un REST point de terminaison qui extrait les feuilles sélectionnées d'un Excel classeur et les renvoie comme nouveau contenu de classeur. POST le fichier comme Base64 à office/ApiV2Excel/ExcelExtractWorksheetNommez les feuilles ou indiquez leurs index (à partir de 0), puis enregistrez le résultat décodé. Si vous n'envoyez aucun sélecteur, toutes les feuilles de calcul seront extraites.
Permet de diviser un classeur par feuille. Vous envoyez le fichier complet une seule fois et indiquez les feuilles à inclure. extraire la feuille de calcul vers ExcelLa sélection peut se faire par nom d'onglet exact (sensible à la casse), par index (à partir de 0) ou par les deux simultanément (l'union est prise en compte). Cette fonction remplace la procédure manuelle de clic droit, Déplacer ou Copier pour la distribution de rapports, la répartition par équipe et tout flux de travail où les destinataires ne doivent voir que leur propre feuille.
Authentification de votre API Demande
Chaque PDF4me REST L'appel doit inclure votre API clé dans le Authorization En-tête : Authentification de base. Récupérez ou renouvelez votre clé depuis le tableau de bord développeur.
Point de terminaison
office/ApiV2Excel/ExcelExtractWorksheetInformations importantes à ne pas manquer
Noms des feuilles de travail, Index des feuilles de calcul, ou les deux ; toute feuille correspondant à l’une ou l’autre liste est extraite. Si vous omettez les deux, TOUTES les feuilles de calcul sont extraites, ce qui est rarement souhaitable pour une séparation ciblée.office/ApiV2Excel/ sur le même hôte, pas sous /api/v2/Le corps est également imbriqué : un objet action (extraire la feuille de calcul vers Excel) au lieu de champs racines plats.HTTP installation
Méthode: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
Type de contenu : application/json
Authorization: Basique <votre PDF4me API clé>
La réponse est : JSON: vérifiez le success drapeau, puis Base64-décoder le contenu du classeur renvoyé et l'enregistrer avec un .xlsx extension.
Quelles feuilles sont extraites : les noms ou les index ?
La sélection est déclarative. Vous n'avez jamais besoin de réorganiser ni de parcourir les feuilles ; vous décrivez les feuilles cibles une seule fois et le moteur les résout en fonction du classeur.
| Noms vs index | Vous envoyez | Ce qui est extrait |
|---|---|---|
| Noms seulement | "worksheetNames": ["Sheet1", "Summary"] | Feuilles dont le nom de l'onglet correspond exactement (sensible à la casse) |
| Index uniquement | "worksheetIndexes": [0, 2] | Feuilles à ces positions de base 0 |
| Les deux | noms + index | L'union : tout ce qui correspond à l'une ou l'autre des listes |
| Ni l'un ni l'autre | {} objet d'action | Chaque feuille de travail du cahier d'exercices |
API champs corporels
| Paramètre | Requis | Taper | Ce que cela fait | Exemple |
|---|---|---|---|---|
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 |
Exemples de charges utiles
Extraire deux feuilles par nom
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Sheet1", "Summary"]
}
}
Extraction par index à partir de 0
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetIndexes": [0, 2]
}
}
Conseils pour la collecte par le facteur
Exemple 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
Que signifie le API retour?
UN JSON résultat décrivant l'extraction et le transport du nouveau contenu du classeur comme Base64.
| Champ | Taper | Ce qu'il contient |
|---|---|---|
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. |
Exemples de code
Excel Les terminaux de bureau ne sont pas encore couverts par per-language dossiers d'exemples ; le dépôt d'exemples contient le modèle de requête utilisé par chaque PDF4me famille de points de terminaison :
FAQ
Pourquoi extraire des feuilles de calcul via API au lieu de manuellement ?
La voie manuelle est Déplacer ou copier des feuilles de travail dans Excel: cliquez avec le bouton droit sur l'onglet, Déplacer ou Copier, cochez Créer une copie, enregistrez comme nouveau fichier, répétez l'opération pour chaque feuille, chaque classeur, chaque cycle de reporting. API Cette boucle est remplacée par une requête déterministe par fractionnement, ce qui est idéal lorsque le classeur arrive à intervalles réguliers et que le fractionnement alimente d'autres systèmes. La sortie reste standard. Office Open XML cahier d'exercices qui ExcelLibreOffice et Google Sheets sont tous ouverts.