跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

添加图片页眉页脚 - Excel API

PDF4me 添加图片页眉页脚 允许您添加可自定义的图像页眉和页脚 Excel 具有全面定位和格式控制功能的文档。 API 服务流程 Excel 文件并添加图像页眉或页脚，可控制位置（页眉/页脚）、水平对齐方式（左对齐、居中、右对齐）、工作表目标（特定工作表或所有工作表）以及以厘米为单位的页面边距。 API 接收 Excel 通过文档内容和图像数据 REST API 利用电话 Base64 用于安全传输的编码。支持 PNG， JPG， JPEG该解决方案支持 JPEG 和 GIF 图像格式，是企业品牌推广、专业报告和文档自动化工作流程的理想选择。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

验证您的身份 API 要求​

请包含您的 API 请求中用于身份验证的密钥 PDF4me REST API。

Get your api Key

主要特点​

  • 页眉或页脚位置选择将图像放置在文档页眉还是页脚部分。
  • 位置控制在页眉/页脚区域内，将图像左对齐、居中对齐或右对齐。
  • 工作表目标：按名称或索引将图像应用于特定工作表，或应用于所有工作表
  • 利润率定制：以厘米为单位配置页面上、下、左、右边距
  • 图像格式支持： PNG， JPG， JPEG以及 GIF 格式

REST API 端点​

这 PDF4me REST API 使用标准 HTTP 与资源交互的方法。所有图像头部/尾部操作 Excel 通过单个端点执行：

  • 方法： POST
  • 终点： office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API 参数​

重要的： 标有星号 (*) 的参数为必填项。所有请求均使用 文档， 文档内容， 图片内容 （根级别），以及 addImageHeaderFooterToExcelAction其他选项是操作对象的属性。

必需参数（根级别）​

范围类型描述例子
文档*Object文件参考。必须包含 姓名 （细绳）： Excel 文件名带有 .xlsx 或 .xls 扩展名。{ "Name": "data.xlsx" }
文档内容*String （Base64）Excel 文档内容编码 Base64UEsDBBQABgAIAAAA...
图片内容*String （Base64）图像文件内容编码为 Base64支持 PNG， JPG， JPEGGIF格式iVBORw0KGgoAAAANS...
addImageHeaderFooterToExcelAction*Object操作配置（位置、工作表目标、边距等）请参见下方的有效载荷示例。

可选参数（位于 addImageHeaderFooterToExcelAction 函数内部）​

范围类型描述例子
isHeaderBoolean岗位选择。 true = 将图像添加到文档头部（默认）， false = 在文档页脚添加图片true
位置String页眉/页脚内的水平对齐方式。 左边， 中心， 或者 正确的默认值：“居中”。不区分大小写。Center
工作表名称Array （细绳[]）要应用图像的工作表名称数组。如果 worksheetNames 和 worksheetIndexes 都为空，则图像应用于所有工作表。["Sheet1", "Report"]
工作表索引Array （int[]）工作表索引数组（从 1 开始）。如果 worksheetNames 和 worksheetIndexes 都为空，则应用于所有工作表。[1, 2]
上边距数字（双精度浮点数）页面顶部边距（厘米）。默认值：1.91.9
底部边距数字（双精度浮点数）页面底部边距（厘米）。默认值：1.91.9
左边距数字（双精度浮点数）页面左边距，单位为厘米。默认值：1.91.9
右边距数字（双精度浮点数）页面右边距，单位为厘米。默认值：1.91.9
文化名称String文档处理的区域性代码（例如“en-US”、“de-DE”、“fr-FR”）en-US

笔记： 如果两者 工作表名称 和 工作表索引 如果为空或为null，则图像将应用于所有工作表。 Excel 文件。

输出​

这 PDF4me 添加图片页眉页脚 REST API 返回 Excel 以文件形式 Base64-编码字符串 JSON 格式不是二进制数据。

同步处理（默认）

这 API 处理请求并返回：

状态码： 200 OK

Content-Type： application/json

回复正文：

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}

回复字段：

  • 文档 （字符串）： Excel 应用了图像页眉/页脚的文档，编码为 Base64 细绳
  • 文件名 （字符串）：输出 Excel 文件名
  • 成功 （布尔值）：指示请求是否成功
  • 错误信息 （字符串或 null）：成功失败时的错误详情

使用方法：

  1. 提取 document 来自该领域的 JSON 回复 （Base64）
  2. 解码 Base64 获取二进制文件的字符串 Excel 文档数据
  3. 保存或处理 Excel 根据需要归档

例子 （JavaScript）：

const response = await fetch(url, options);
const data = await response.json();
const excelBytes = atob(data.document); // Decode Base64
// Save or process excelBytes

请求示例​

标题​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

笔记：

  • 获得你的 API 钥匙 PDF4me 仪表板
  • 这 API 关键必须是 Base64 编码后以“Basic”为前缀 Authorization 标题
  • 例如：如果你的 API 关键是 abc123将其编码为 Base64 并使用 Authorization: Basic YWJjMTIz

有效载荷​

基本示例（仅必填字段）：

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {}
}

高级示例（包含所有可选字段）：

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {
 "isHeader": true,
 "position": "Center",
 "worksheetNames": ["Sheet1", "Report"],
 "worksheetIndexes": [1, 2],
 "topMargin": 1.9,
 "bottomMargin": 1.9,
 "leftMargin": 1.9,
 "rightMargin": 1.9,
 "cultureName": "en-US"
 }
}

代码示例​

这 PDF4me 添加图像页眉页脚 Excel REST API 提供多种编程语言的代码示例。请选择最适合您开发环境的语言：

C# (CSharp) 示例

完全的 C# 实现向图像添加页眉/页脚的功能 Excel 文件：

行业应用案例及应用​

财务与会计应用案例

  • 财务报表在季度报告中添加公司徽标标题
  • 预算报告在预算工作表上插入部门徽标
  • 审计文件在页脚添加审计公司标志水印
  • 费用报告：在费用报销单上添加公司标志页眉

获取帮助​

Get Your API KeyAPI SamplesGetting Started