怎样把PDF以Base64形式发送给API
电子发票、电子签名或物流接口要求把文档放进JSON字段。下面介绍怎样把PDF转成正确的文本、检查结果,并避开导致请求失败的常见错误。
作者: Metin Ersoy · 更新于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