Як надіслати PDF в API у форматі Base64
API електронних рахунків, електронного підпису чи доставки чекає документ у полі JSON. Пояснюємо, як перетворити PDF на правильний текст, перевірити його й уникнути помилок, через які запит не проходить.
Автор: Metin Ersoy · Оновлено 10 листопада 2026 р.
Що зазвичай очікує API
Більшість API для документів описують тіло JSON із полем content, file, data або document. Його значення — Base64-код PDF-файлу, часто поруч із назвою файлу й типом:
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Перш ніж писати код, знайдіть у документації три речі: назву поля, чи потрібен префікс data: (зазвичай ні) і обмеження розміру.
1. Перетворіть PDF на Base64
Найшвидше отримати тестове значення можна в інструменті PDF в Base64. Виберіть PDF-файл, позначте Лише Base64-код (починається з JVBERi0) і скопіюйте результат. Якщо потрібне готове тіло запиту, виберіть натомість JSON з назвою файлу, типом і вмістом — назву файлу й тип буде додано автоматично. PDF кодується у вашому браузері й нікуди не вивантажується, а це важливо, коли тестовий документ — справжній рахунок.
Перевірте результат: він має починатися з JVBERi0, не містити пробілів і, крім одного-двох знаків = у кінці, складатися лише з літер, цифр, + і /.
2. Надішліть його з коду
Той самий крок трьома поширеними мовами. Кожен приклад читає файл, кодує його й надсилає JSON:
# curl (Linux / macOS): base64 -w 0 keeps it on one line
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 with 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 замість -w 0 пишіть base64 -i invoice.pdf. Адреса й назви полів наведено для прикладу — беріть ті, що вказано в документації вашого сервісу.
3. Перевірте зворотне перетворення
Якщо сервіс повертає документ або збережену копію в Base64, вставте цю відповідь в інструмент Base64 в PDF. Побачити першу сторінку й кількість сторінок — найшвидший спосіб переконатися, що дорогою нічого не загубилося. Докладні кроки для цього напрямку — у посібнику Як зберегти рядок Base64 як PDF-файл.
Типові помилки
| Ознака | Імовірна причина | Що зробити |
|---|---|---|
| «Invalid Base64» | Розриви рядків (рядки по 76 символів) або префікс data: | Надішліть чистий код в один рядок |
| «Payload too large» (413) | PDF після кодування завеликий | Зменште його інструментом Стиснути PDF |
| PDF відкривається порожнім або пошкодженим | Рядок обрізано | Закодуйте ще раз і надішліть усе значення |
| Назви з літерами кирилиці чи діакритикою відображаються неправильно | Назву файлу надіслано в неправильному кодуванні | Тримайте тіло JSON у кодуванні UTF-8 |
Хочете спробувати? Це безкоштовно, а ваш файл залишається на вашому пристрої.
Відкрити інструмент «PDF в Base64»