Порівняння

Ласкаво просимо до офіційного центру документації API порівняння — спеціально створеного рішення, яке перетворює часто виснажливу задачу керування версіями електронних таблиць у спрощений, орієнтований на розробників робочий процес. Незалежно від того, чи ви аналітик даних, що звіряє квартальні звіти, фінансова команда, що слідкує за змінами бюджету, чи інженер‑програміст, який вбудовує можливості порівняння у більший конвеєр даних, цей API розроблений так, щоб відповідати вашим потребам і усунути здогадки при виявленні змін у широкому спектрі форматів електронних таблиць. У своїй суті API порівняння працює за простим, але потужним принципом: ви передаєте два вихідних файли — будь‑то з Apple Numbers, CSV/TSV‑експорту або всебічно поширеного Excel (.xlsx, .xls) — а сервіс повертає один результатний файл, який підсвічує кожне додавання, видалення та зміну з кристально чіткими візуальними підказками. Наголос на чіткості — це не післядумування; кожна різниця анотована так, щоб відповідати рідним конвенціям електронних таблиць (кольорові фони клітинок, коментарі‑бульбашки, маркери рядків/стовпців), що дозволяє кінцевим користувачам відкрити результат у обраному застосунку та миттєво зрозуміти, що змінилося. Поза базовим порівнянням API також зберігає оригінальне форматування, формули та типи даних, гарантуючи, що результатом є не просто текстовий звіт, а повнофункціональна робоча книга, готова до подальшого аналізу чи розповсюдження. Безпека та продуктивність вбудовані в кожен запит: всі передачі файлів здійснюються через TLS 1.3, файли обробляються в ізольованих контейнерах з суворими обмеженнями пам’яті, а результати зазвичай повертаються менш ніж за секунду для файлів розміром до 10 МБ, плавно масштабуючись для більших наборів даних за допомогою потокової передачі частинами. Документація, яку ви зараз читаєте, організована так, щоб ви змогли розпочати роботу за кілька хвилин — починаючи з автентифікації, переходячи до конструювання запитів і завершуючи шаблонами кращих практик обробки помилок, пагінації та інтеграції вебхуків. Протягом усього документа ви знайдете фрагменти коду на Python, JavaScript, Java та C#, які показують, як один рядок коду може запустити повне порівняння, а також середовище‑пісочницю, де можна експериментувати з реальними файлами без виходу з браузера. Після завершення цього посібника ви отримаєте міцне розуміння того, як вбудувати надійне, високоточне порівняння електронних таблиць у будь‑який робочий процес, скоротити час ручної перевірки та надати зацікавленим сторонам прозорі, аудиторські журнали змін — все це за допомогою API, який одночасно безпечний, швидкий та простий у використанні.

Основні функції

API порівняння пропонує широкий набір функцій, який вирішує найпоширеніші проблеми, що виникають під час узгодження даних електронних таблиць на різних платформах. Перш за все, API підтримує велику кількість форматів файлів: Apple Numbers (.numbers), прості текстові файли з розділювачами (CSV, TSV), застарілий Excel (.xls) та сучасний Excel (.xlsx). Це усуває необхідність у попередньому конвертуванні, дозволяючи подавати оригінальні файли безпосередньо в сервіс. Двигун порівняння працює на рівні клітинки, виявляючи зміни у значеннях, формулах і навіть у форматуванні, такому як стиль шрифту, затінення клітинок і правила перевірки даних; кожна різниця чітко підсвічується в результуючій робочій книзі за допомогою налаштовуваних кольорових схем, що спрощує інтерпретацію результатів неділовими користувачами. Для великих наборів даних API пропонує інкрементний режим порівняння, дозволяючи порівнювати лише рядки, які були додані або змінені з моменту попередньої бази, тим самим зменшуючи час обробки та мережеву пропускну здатність. Додатково, ви можете запросити структурований JSON‑огляд змін поряд із візуальним файлом diff, що полегшує автоматизацію, наприклад, сповіщення, оновлення дашбордів або передачу змін у системи контролю версій. Функції безпеки включають автентифікацію за допомогою OAuth 2.0 bearer‑токена, обмежені API‑ключі та опціональне біле листування IP‑адрес, а дані в спокої зашифровані за допомогою AES‑256. Сервіс також відповідає вимогам GDPR та CCPA, що дає впевненість при роботі з конфіденційною особистою чи фінансовою інформацією. Щодо продуктивності, API спроектовано для низької затримки; завдяки горизонтальному масштабуванню та алгоритмам diff у пам’яті, більшість порівнянь завершується менш ніж за секунду для стандартних робочих книг, з підтримкою асинхронної обробки через вебхуки для файлів понад 50 МБ. Нарешті, досвід розробника є пріоритетом: повні специфікації OpenAPI, автогенеровані SDK, докладні коди помилок та заголовки обмежень швидкості в режимі реального часу дозволяють інтегрувати API з мінімальними зусиллями, а наша консоль‑пісочниця та обширний репозиторій прикладів демонструють кращі практики для пакетної обробки, CI/CD‑конвеєрів та безсерверних функцій. Коротко кажучи, API порівняння забезпечує швидкі, безпечні та зручні для розробників можливості diff електронних таблиць, які дозволяють виявляти зміни одним простим викликом — незалежно від формату, розміру чи складності даних, які ви обробляєте.

Документи

Параметри

format: Підтримуваний формат вихідного файлу.
UploadFileRequest.OperationId: Це ідентифікатор операції.
UploadFileRequest.Files: Це файли, які потрібно завантажити в наші онлайн‑сервіси; ви можете підготувати дані у будь‑який спосіб, але вони повинні відповідати стандарту HTML‑полю вводу файлу.

Використання кінцевої точки

Надішліть запит, який містить файли та токен доступу. API порівняння

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.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'
Ви отримаєте файл і можете або використати його, або просто передати наступному кроку вашого робочого процесу.