PDFVela — pdfvela.com
Усі інструменти PDF

Як надіслати PDF в API у форматі Base64

API електронних рахунків, електронного підпису чи доставки чекає документ у полі JSON. Пояснюємо, як перетворити PDF на правильний текст, перевірити його й уникнути помилок, через які запит не проходить.

Автор: · Оновлено 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»

Запитання про надсилання PDF у Base64

Чому API просять Base64, а не сам файл?

JSON може передавати лише текст. Base64 записує байти PDF-файлу літерами, цифрами, знаками + і /, тож увесь документ уміщується в одне рядкове поле поруч з іншими даними, наприклад номером клієнта чи датою рахунку.

Чи треба надсилати префікс data:application/pdf;base64,?

Зазвичай ні. Більшість API очікує лише сам код, який починається з JVBERi0. Data URI надсилайте лише тоді, коли його показано в документації або коли браузеру потрібна адреса, наприклад для iframe.

API пише, що Base64 недійсний. Яка найчастіша причина?

Переноси рядків чи префікс у значенні або код, який обрізався під час вставлення. Передавайте чистий код одним рядком і перевірте, чи кінець значення дійшов повністю.

Наскільки великим може бути PDF?

Це залежить від сервісу, але текст приблизно на третину більший за файл, тож PDF на 3 МБ перетворюється приблизно на 4 МБ JSON. Багато API приймають лише кілька мегабайтів; найпростіше рішення — спершу стиснути PDF.

Чи є Base64 шифруванням?

Ні. Будь-хто, хто має код, може перетворити його назад на документ. Надсилайте його лише через HTTPS і ніколи не вставляйте конфіденційний PDF на сайт, який його вивантажує.