添加行 - Excel API
PDF4me 添加行 使您能够插入 JSON 数据以行的形式输入 Excel 支持基于表格或基于坐标的插入模式的文档。 API 该服务支持自动类型转换（字符串到数字/日期）、特定区域性解析、可自定义的日期和数字格式以及空值处理。 API 接收 Excel 文件内容和 JSON 通过数据 REST API 利用电话 Base64 用于安全传输的编码。此解决方案非常适合自动数据填充、报告生成以及数据库到 Excel 的工作流程。
相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →
验证您的身份 API 要求
请包含您的 API 请求中用于身份验证的密钥 PDF4me REST API。
主要特点
- 双重插入模式：基于表格（表头匹配）或基于坐标（精确的行/列定位）
- JSON 数据支持插入单个对象或对象数组 Excel 行
- 自动类型转换： 转变 JSON 字符串 Excel 数字和日期
- 格式自定义应用自定义日期和数字格式模式
- 文化支持根据指定的文化代码解析日期和数字
- 空值处理跳过空值或将其插入为空单元格
REST API 端点
- 方法： POST
- 终点：
office/ApiV2Excel/ExcelAddRows
REST API 参数
重要的： 标有星号 (*) 的参数为必填项。所有请求均使用 文档， 文档内容， 和 addRowsToExcel 操作操作特定的参数（jsonInput、worksheetName 等）是操作对象的属性。
必需参数（根级别）
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 文档* | Object | 文件参考 姓名 （Excel 文件名） | { "Name": "data.xlsx" } |
| 文档内容* | String （Base64） | Excel 文档内容编码 Base64 | UEsDBBQABgAIAAAA... |
| addRowsToExcel 操作* | Object | 操作配置。必须包含 json输入 （细绳）： JSON 数据可以是对象数组或单个对象。 | 请参见下方的有效载荷示例。 |
可选参数（位于 addRowsToExcelAction 内部）
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 工作表名称 | String | 目标工作表名称。默认值：“Sheet1” | Sheet1 |
| tableName | String | Excel 表格模式的表名；空 = 基于坐标的模式 | SalesTable |
| excelRowNumber | 数字（整数） | 表格内从 1 开始的位置（仅限表格模式） | 5 |
| insertFromRow | 数字（整数） | 基于 1 的起始行（仅限坐标模式） | 10 |
| insertFromColumn | 数字（整数） | 基于 1 的起始列（仅限坐标模式） | 3 |
| convertNumericAndDate | Boolean | 自动类型转换。默认值：true | true |
| 日期格式 | String | Excel 日期格式模式。默认值：“yyyy-MM-dd” | MM/dd/yyyy |
| 数字格式 | String | Excel 数字格式模式。默认值：“N2” | #,##0.00 |
| 忽略空值 | Boolean | 跳过空值。默认值：false | false |
| 忽略属性标题 | Boolean | 不区分大小写的标头匹配。默认值：false | true |
| 文化名称 | String | 日期/数字解析区域设置。默认值：“en-US” | en-US |
输出
这 API 返回 Excel 以文件形式 Base64-编码字符串 JSON 格式 （文档，文件名，成功，错误消息）。
请求示例
标题
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
有效载荷（基本）
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}