Сравнение

Добро пожаловать в официальный центр документации 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). Это устраняет необходимость в инструментах предварительного преобразования, позволяя загружать оригинальные файлы напрямую в сервис. Движок сравнения работает на уровне ячеек, обнаруживая изменения в значениях, формулах и даже в атрибутах форматирования, таких как стиль шрифа, заливка ячеек и правила проверки данных; каждое отклонение явно выделяется в результирующей книге с помощью настраиваемых цветовых схем, упрощая интерпретацию результата для нетехнических reviewers. Для больших наборов данных API предлагает режим инкрементального сравнения, позволяющий сравнивать только строки, добавленные или изменённые после предыдущей базовой версии, тем самым сокращая время обработки и сетевой трафик. Кроме того, вы можете запросить структурированное JSON‑сводку изменений в дополнение к визуальному файлу diff, что позволяет автоматизировать дальнейшие процессы, такие как генерация оповещений, обновление панелей мониторинга или передача изменений в системы контроля версий. К средствам безопасности относятся аутентификация OAuth 2.0 с токеном‑носителем, ограниченные API‑ключи и опциональное белое список IP, а данные в состоянии покоя зашифрованы с помощью AES‑256. Сервис также соответствует требованиям GDPR и CCPA, что даёт уверенность при работе с конфиденциальной персональной или финансовой информацией. С точки зрения производительности API построен для низкой задержки; благодаря горизонтальному масштабированию и алгоритмам сравнения в памяти большинство сравнений завершаются менее чем за секунду для таблиц стандартного размера, при этом поддерживается асинхронная обработка через веб‑хуки для файлов более 50 МБ. Наконец, удобство разработчика является главным приоритетом: полные спецификации OpenAPI, автоматически генерируемые SDK, подробные коды ошибок и заголовки ограничения скорости в реальном времени позволяют интегрировать API с минимальными трениями, а наша консоль‑песочница и обширный репозиторий примеров демонстрируют лучшие практики для пакетной обработки, конвейеров CI/CD и серверлесс‑функций. Короче говоря, API сравнения предоставляет быстрые, безопасные и удобные для разработчиков возможности сравнения электронных таблиц, позволяя обнаруживать изменения одной простой вызовом — независимо от формата, размера или сложности обрабатываемых данных.

Документы

Параметры

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

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

Отправьте запрос, включающий файлы и токен доступа 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'
Вы получите файл и сможете либо использовать его, либо просто передать на следующий шаг вашего рабочего процесса.