Extraire les lignes de Excel
PDF4me Extraire les lignes est un REST point de terminaison qui lit les lignes d'une feuille de calcul à partir d'un Excel classeur et les renvoie sous forme structurée JSON. POST le fichier .xlsx comme Base64 à office/ApiV2Excel/ExcelExtractRows, définissez la portée de la feuille de calcul et de la plage de lignes dans l'objet d'action, et consommez le rowData tableau. Il renvoie des données, pas un fichier : document renvoie une valeur nulle.
Transforme une tranche de feuille de calcul en un JSON tableau : chaque ligne devient un objet dans données de ligne, prêt pour une insertion dans la base de données, un API appel ou rapport. Il s'agit de l'équivalent en lecture seule des fonctions Ajouter des lignes et Mettre à jour des lignes. API-équivalent côté exportation Excel données sans ouverture ExcelAucun fichier modifié n'est produit.
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/ExcelExtractRowsInformations importantes à ne pas manquer
document et fileName renvoyer null par conception ; code qui attend une valeur nulle Base64 Le fichier à cet endroit va se corrompre.HTTP installation
Méthode: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractRows
Type de contenu : application/json
Authorization: Basique <votre PDF4me API clé>
La réponse est : JSON: vérifiez le success drapeau, puis itérez le données de ligne Tableau. Aucun fichier à décoder.
En quoi Extraire les lignes diffère-t-il des autres Excel actions de ligne ?
La famille de lignes couvre les opérations d'écriture, d'écrasement et de lecture. Choisissez en fonction de l'action à effectuer sur le classeur.
| Action vs comportement | Ce que cela fait au cahier d'exercices | Ce que vous récupérez |
|---|---|---|
| Extraire les lignes (ce point de terminaison) | Rien, en lecture seule | UN rowData JSON tableau, un objet par ligne |
| Ajouter des lignes | Ajoute ou insère de nouvelles lignes | Le classeur modifié comme Base64 |
| Mettre à jour les lignes | Remplace les valeurs des lignes existantes | Le classeur modifié comme Base64 |
| Supprimer les lignes | Supprime les lignes | Le classeur modifié comme Base64 |
API champs corporels
| Paramètre | Requis | Taper | Ce que cela fait | Exemple |
|---|---|---|---|---|
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 |
Exemples de charges utiles
Lisez la feuille de calcul par défaut
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {}
}
Lisez une fiche de travail intitulée « Valeurs tenant compte de la culture »
{
"document": { "Name": "sales.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractRowsToExcelAction": {
"worksheetName": "Q3",
"cultureName": "en-US"
}
}
Conseils pour la collecte par le facteur
Exemple 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
Que signifie le API retour?
UN JSON résultat dont la charge utile est le rowData tableau.
| Champ | Taper | Ce qu'il contient |
|---|---|---|
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" }
]
}
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 Excel donné API au lieu de manuellement ?
La méthode manuelle consiste à ouvrir le classeur, à sélectionner la plage de données, à la copier quelque part, puis à la remodeler manuellement, une fois par fichier, à chaque actualisation. API lit les mêmes lignes qu'une seule requête déterministe et vous les transmet JSON que n'importe quel language analyse nativement, sans Excel installation sur le serveur. Car la source reste une norme Office Open XML Le classeur et l'opération étant en lecture seule, le même appel peut être exécuté en toute sécurité de manière planifiée sur des fichiers actifs.