Excel в Base64

Как конвертировать файл Excel в Base64

1. Перетащите файл .xlsx, .xls или .csv в поле или выберите его через диалог выбора файла.
2. В списке Формат вывода уже выбран Чистый Base64. Выберите JSON, чтобы добавить имя файла, MIME-тип и размер.
3. Нажмите Скопировать результат или, для больших книг, Сохранить как .txt.

Что это за таблица?

В выводе data URI и JSON используется тип, который сообщает браузер. На компьютерах с Windows и установленным Excel система часто помечает файлы .csv как application/vnd.ms-excel. Если API строго проверяет CSV, исправьте тип на text/csv вручную.

CSV хранится как обычный текст

Base64 от CSV декодируется в читаемые строки, и это стоит учитывать:

• Кодировка символов передаётся вместе с байтами. CSV, который Excel сохранил в устаревшей кодовой странице вроде Windows-1252, раскодируется в неправильные символы, если получатель считает, что это UTF-8. При сохранении выбирайте «CSV UTF-8».
• Большой CSV сильно ужимается gzip или ZIP, и это стоит сделать до кодирования, если API принимает сжатые файлы. .xlsx уже сжат как ZIP, так что повторное сжатие почти ничего не даст.
• Чтобы быстро посмотреть CSV, который пришёл в виде Base64, откройте Base64 в CSV: он декодирует данные и покажет их как текст.

Где таблицы передаются в Base64

• API отчётов и импорта, которые принимают книгу в теле JSON-запроса, например для массовой загрузки товаров или цен.
• Платформы автоматизации, которые передают файлы между шагами в виде строк Base64: скажем, берут вложение из письма и загружают его в хранилище.
• API транзакционных рассылок, которые принимают вложения как поля Base64 в JSON.
• Ссылки на скачивание в сгенерированном HTML: формат вывода HTML <a download> встраивает .xlsx прямо в страницу отчёта.

Кодирование и проверка формата в Python

import base64
from pathlib import Path

SIGNATURES = {
    "UEsDB": "xlsx (ZIP)",
    "0M8R4KGxGuE": "xls (OLE2) or encrypted xlsx",
    "77u/": "text with a UTF-8 BOM, e.g. CSV UTF-8",
}

def encode_sheet(path):
    b64 = base64.b64encode(Path(path).read_bytes()).decode("ascii")
    kind = next((v for k, v in SIGNATURES.items() if b64.startswith(k)), "other")
    return b64, kind

Такая проверка ловит частую ошибку при загрузке: «таблицу», которая на деле оказывается HTML-страницей с ошибкой или старым .xls, переименованным в .xlsx. Больше о работе с файлами в статье Base64 в Python, а Base64 в Excel покажет книгу из Base64 и сохранит её как файл.

Вопросы и ответы