PDFVela — pdfvela.com

怎样把PDF以Base64形式发送给API

电子发票、电子签名或物流接口要求把文档放进JSON字段。下面介绍怎样把PDF转成正确的文本、检查结果,并避开导致请求失败的常见错误。

作者: · 更新于2026年11月10日

API通常要什么格式

大多数文档类API都要求一个JSON请求体,其中有一个名为content、file、data或document的字段。它的值就是PDF的Base64代码,旁边通常还有文件名和类型:

{
  "fileName": "invoice-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

动手写代码之前,先在接口文档里确认三件事:字段名、是否需要data:前缀(通常不需要),以及大小限制。

1. 把PDF转成Base64

想快速拿到一个测试值,最省事的是PDF转Base64。选择PDF,选仅Base64代码(以JVBERi0开头),然后复制结果。如果想直接拿一个完整的请求体来改,就选JSON,包含文件名、类型和内容,它会自动加上文件名和类型。PDF在浏览器中编码,不会上传。如果测试用的是一张真实发票,这一点尤其重要。

检查一下结果:应以JVBERi0开头,不含空格,除了末尾的一两个=号之外,只有字母、数字、+和/。

2. 在代码中发送

下面是三种常用语言的写法,都是读取文件、编码,再以JSON形式POST出去:

# curl(Linux / macOS):base64 -w 0 让结果保持在一行
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3,使用requests
import base64, requests
with open("invoice.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "invoice.pdf", "content": content})

在macOS上,curl这一行要用base64 -i invoice.pdf,而不是-w 0。地址和字段名只是示例,请以所用服务的接口文档为准。

3. 检查往返结果

如果服务以Base64形式返回文档或已保存的副本,把返回内容粘贴到Base64转PDF。看到第一页和页数,就能最快确认传输过程中没有丢失内容。反方向的详细步骤见Base64字符串怎么保存为PDF文件。

常见错误

现象可能原因解决办法
“Invalid Base64”有换行(每行76个字符)或带了data:前缀发送只占一行的纯代码
“Payload too large”(413)编码后PDF太大用压缩PDF减小体积
PDF打开后是空白或已损坏字符串被截断重新编码,完整发送整个值
含中文或重音字母的文件名显示乱码文件名编码不对JSON请求体统一使用UTF-8

想试试吗?完全免费,文件始终留在您的设备上。

打开PDF转Base64

以Base64发送PDF常见问题

为什么API要的是Base64,而不是文件本身?

JSON只能传文本。Base64用字母、数字、+和/来表示PDF的字节,这样整份文档就能放进一个字符串字段,和客户编号、发票日期等其他数据放在一起。

要不要带上data:application/pdf;base64,前缀?

通常不要。大多数API只需要代码本身,也就是以JVBERi0开头的那一串。只有文档里明确这样写,或者浏览器需要一个URL(比如在iframe中)时,才用data URI。

API提示Base64无效,最常见的原因是什么?

字符串里有换行或前缀,或者粘贴时代码被截断了。请使用不带前缀、只占一行的纯代码,并检查字符串末尾是否完整。

PDF最大可以多大?

取决于具体服务。不过编码后的文本比文件大约多出三分之一,3MB的PDF会变成约4MB的JSON。很多API的上限只有几MB,最简单的办法是先压缩PDF。

Base64算加密吗?

不算。任何拿到代码的人都能把它还原成文档。请只通过HTTPS发送,也不要把机密PDF粘贴到会上传文件的网站上。