什么时候需要把PDF转成Base64?
JSON、XML和许多表单只能传输文本,因此像PDF这样的二进制文件必须先写成文本。Base64就是最常用的做法:
- 把文档发送给API。电子发票、电子签名、物流和文档管理服务常常要求把PDF放在名为content、file或data的字段中。
- 测试自己的接口对接。选择JSON格式即可得到现成的请求体,直接粘贴到Postman、curl或单元测试中,不用自己写编码代码。
- 存入文本字段或配置文件。有些系统把小型模板或证书存为文本,转成Base64后PDF就能放进去。
- 嵌入网页。用data URI可以让网页在iframe中显示PDF,无需另外托管文件,适合小型文档。
curl、JavaScript和Python的分步请求示例,请参阅如何以Base64格式把PDF发送给API。要把代码还原成文件,请使用Base64转PDF;图片请使用图片转Base64。
各种格式长什么样
| 格式 | 开头 | 典型用途 |
|---|---|---|
| 仅Base64代码 | JVBERi0 | API字段、JSON、XML、数据库 |
| Data URI | data:application/pdf;base64, | 浏览器标签页、iframe、object标签 |
| 每行76个字符 | JVBERi0,分成多个短行 | 邮件附件(MIME)、PEM格式文件 |
| JSON | { "fileName": … } | 测试接口对接用的请求体 |
遇到问题怎么办
提示“这个文件不是有效的PDF”。文件开头没有%PDF-标识,可能是改了扩展名为.pdf的Word文件或图片。请先用PDF阅读器打开确认,或用合适的工具转换。
API提示内容无效。请确认发送的是纯代码,不带data:前缀,也没有换行(除非文档要求带上)。另外检查粘贴时末尾有没有被截断。
文本太长,字段放不下。先用压缩PDF减小PDF体积再重新转换,代码长度会按相同比例缩短。