Compress

Ласкаво просимо до офіційної документації Compress, легкого, проте потужного API, створеного для зменшення розмірів файлів електронних таблиць до частки їх початкового розміру за допомогою одного інтуїтивного запиту. У сьогоднішньому світі, орієнтованому на дані, команди постійно обмінюються електронними таблицями, що містять усе — від простих списків до складних фінансових моделей, і величезний обсяг цих файлів швидко стає прихованою витратою — повільні завантаження, збільшені витрати на зберігання та довший час обробки для нижчестоячих систем. Compress усуває ці проблеми, пропонуючи хмарний сервіс, який інтелектуально аналізує внутрішню структуру вашої таблиці, видаляє зайву “вантажність” і переупаковує вміст у оптимізовану, компактну форму без шкоди для цілісності даних чи читабельності. Ця сторінка документації служить єдиним джерелом правди, керуючи вами через усе, що потрібно знати для ефективного використання API, від автентифікації та формування запитів до обробки помилок та стратегій кращих практик для пакетної обробки. Незалежно від того, чи ви досвідчений бек‑енд інженер, який інтегрує дані в конвеєри, фронтенд‑розробник, що прагне покращити користувацький досвід під час завантаження файлів, або ІТ‑менеджер, відповідальний за зменшення витрат на зберігання в організації, цей посібник надасть чіткі покрокові інструкції, кодові фрагменти різними мовами та реальні приклади, які демонструють, як досягти найкращих результатів стиснення для різноманітних форматів таблиць. Протягом документації ви знайдете спеціальні розділи про безпеку — такі як 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‑адресу завантаження нового файлу, розміри оригіналу і стисненого файлу та контрольну суму для перевірки. Додаткові параметри дозволяють точно налаштувати рівень стиснення, зберегти певні листи або whitelist‑увати певні вбудовані об’єкти, якщо потрібно зберегти повну цілісність для подальших застосувань. Доступні комплексні SDK для Python, Node.js, Java та Go, кожен з яких надає стислий обгортковий метод `compressSpreadsheet(filePath, options)`, що повністю абстрагує HTTP‑шар. Детальна документація щодо обмежень швидкості та масових завантажень дозволяє обробляти тисячі файлів за годину, не навантажуючи інфраструктуру, а вбудована логіка повторних спроб та експоненціальне затримування зберігає ваші конвеєри стійкими до короткочасних мережевих збоїв. Коротко, API Compress пропонує швидке, безпечне і дружнє до розробника рішення, яке зменшує обсяг зберігання електронних таблиць, прискорює передачу файлів і спрощує управління даними всього одним простим викликом.

Документи

Параметри

AppRequest.CompressionLevel: Рівень стиснення від одного до дев'яти (1‑9)
UploadFileRequest.OperationId: Це ідентифікатор операції
UploadFileRequest.Files: Це файли, які необхідно завантажити до наших онлайн‑сервісів; ви можете підготувати дані у будь‑який спосіб, але вони мають відповідати стандарту HTML‑тегу input type="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 }
Надішліть запит, що включає ім’я файлу та назву папки до Download API

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