Compress

Добро пожаловать в официальную документацию Compress — лёгкого, но мощного API, предназначенного для уменьшения файлов таблиц до части их исходного размера с помощью единственного, интуитивного запроса. В современном мире, управляемом данными, команды постоянно обмениваются таблицами, содержащими от простых списков до сложных финансовых моделей, и огромный объём этих файлов быстро становится скрытой затратой — более медленные загрузки, рост стоимости хранения и увеличение времени обработки для downstream‑систем. Compress решает эти проблемы, предлагая облачный сервис, который интеллектуально анализирует внутреннюю структуру вашей таблицы, удаляет лишний «балласт» и перепаковывает содержание в оптимизированный, компактный формат без ущерба целостности данных или читаемости. Эта страница документации служит единственным источником правды, проводя вас через всё необходимое для эффективного использования API, от аутентификации и формирования запросов до обработки ошибок и рекомендаций по пакетной обработке. Независимо от того, являетесь ли вы опытным бэкенд‑инженером, интегрирующим конвейеры данных, фронтенд‑разработчиком, стремящимся улучшить пользовательский опыт при загрузке файлов, или IT‑менеджером, отвечающим за снижение расходов на хранение в организации, это руководство предоставит чёткие пошаговые инструкции, примеры кода на нескольких языках и реальные примеры, демонстрирующие, как достичь наилучших результатов сжатия для широкого спектра форматов таблиц. В течение документации вы найдёте отдельные разделы, посвящённые вопросам безопасности — таким как TLS‑шифрование, подписанные JWT‑токены и GDPR‑соответствующая обработка данных, а также бенчмарки производительности, показывающие типичные задержки и пропускную способность при разных нагрузках. Мы также включили обширный FAQ, покрывающий типичные сценарии, матрицу устранения неполадок для быстрой диагностики проблем и ссылки на форумы сообщества, где вы можете делиться опытом с другими разработчиками, использующими Compress в продакшене. К концу этого руководства вы будете уверенно настраивать свои окружения, отправлять правильно сформированный API‑вызов и интерпретировать ответы, чтобы без проблем интегрировать сжатие в существующие рабочие процессы и сразу увидеть ощутимую экономию на стоимости хранения и сетевой пропускной способности. Погрузитесь, изучайте разделы, соответствующие вашей роли, и позвольте Compress взять на себя тяжёлую работу по уменьшению данных, чтобы вы могли сосредоточиться на создании более богатых и отзывчивых приложений.

Основные возможности

Ядро API Compress основано на богатом наборе функций, которые делают сокращение таблиц простым и надёжным. Прежде всего, сервис поддерживает широкий спектр типов файлов — включая Apple Numbers, обычные CSV и TSV, а также форматы Microsoft Excel .xlsx и .xls — так что вы можете отправлять практически любую встречающуюся таблицу без предварительного преобразования. Под капотом движок выполняет многоэтапную оптимизацию: нормализует внутреннюю XML‑ или бинарную структуру файла, устраняет дублирующиеся стили, объединяет одинаковые форматы ячеек, удаляет скрытые строки и столбцы без данных и уплотняет вложенные объекты (изображения, диаграммы, сводные таблицы), применяя без потерь алгоритмы сжатия, адаптированные к каждому типу. Кроме того, API обнаруживает и удаляет избыточные метаданные, комментарии и информацию о версиях, которые обычно увеличивают размер файла, но редко нужны. Все эти операции выполняются в реальном времени, давая результаты за миллисекунды для файлов до 50 МБ и плавно масштабируются до больших документов с контролем нагрузки и обратными вызовами прогресса. Безопасность встроена — каждый запрос передаётся по HTTPS, сервис не хранит копию вашего файла после короткого окна обработки, обеспечивая соответствие строгим требованиям конфиденциальности. С точки зрения разработчика API спроектирован максимально без трений: один POST к эндпоинту `/compress` с файлом в multipart/form‑data возвращает JSON‑ответ, содержащий URL для загрузки нового файла, оригинальный и сжатый размеры, а также контрольную сумму для проверки. Параметры опций позволяют точно настроить уровень сжатия, сохранить отдельные листы или разрешить определённые вложенные объекты, если нужна полная точность для downstream‑приложений. Доступны полные SDK для Python, Node.js, Java и Go, каждый из которых предоставляет короткий обёрточный метод `compressSpreadsheet(filePath, options)`, полностью скрывающий HTTP‑уровень. Подробная документация по ограничениям скорости и эндпоинты массовой загрузки позволяют обрабатывать тысячи файлов в час без перегрузки инфраструктуры, а встроенная логика повторных попыток и экспоненциальное отклонение делают конвейеры устойчивыми к временным сетевым сбоям. В итоге API Compress предлагает быстрое, безопасное и удобное для разработчиков решение, которое уменьшает объём хранения таблиц, ускоряет передачу файлов и упрощает процессы управления данными одним простым вызовом.

Документы

Параметры

AppRequest.CompressionLevel: Уровень сжатия от одного до девяти (1‑9)
UploadFileRequest.OperationId: Это идентификатор операции
UploadFileRequest.Files: Это файлы, которые необходимо загрузить в наш онлайн‑сервис; вы можете подготовить данные любым способом, но они должны соответствовать стандарту HTML‑input file.

Использовать конечную точку

Отправьте запрос, включающий файлы и токен доступа Compress API

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
Сервис ответит URL‑адресом для загрузки обработанного файла, в данном примере он выглядит так:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Отправьте запрос, включающий имя файла и имя папки в API загрузки

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Вы получите файл и сможете либо использовать его, либо просто передать на следующий шаг вашего рабочего процесса.