Clear

Clear Spreadsheet API разработан как окончательное решение для разработчиков, которым необходимо программно удалять нежелательные элементы из файлов таблиц одним надёжным вызовом. Эта страница документации служит вашим всесторонним руководством, шаг за шагом описывая всё необходимое для уверенной интеграции сервиса в ваши приложения. Мы начинаем с обзора основных концепций API, объясняя, как сервис интерпретирует различные форматы таблиц — от современных файлов Office Open XML (.xlsx) до устаревших двоичных файлов Excel (.xls), а также Apple Numbers, CSV, TSV и прочих табличных представлений. Понимание нюансов этих типов файлов важно, поскольку каждый формат хранит гиперссылки, изображения, диаграммы и встроенные объекты в разной структуре; Clear API абстрагирует эту сложность и предоставляет единый интерфейс, работающий во всех случаях.

Основные функции

Далее вы найдёте подробный обзор процесса аутентификации. Платформа использует отраслевые стандарты — ключи API и необязательные токены OAuth 2.0 — чтобы гарантировать, что только авторизованные клиенты могут вызывать операции очистки данных. Лучшие практики безопасности, такие как ротация ключей, белый список IP‑адресов и зашифрованная передача по HTTPS, рассмотрены подробно, что позволяет защитить как вашу инфраструктуру, так и данные конечных пользователей. После аутентификации раздел «Начало работы» предоставляет быстрый пример кода на нескольких языках (cURL, Python, JavaScript, .NET и Java), демонстрируя, как сформировать нагрузку запроса, прикрепить файл таблицы и обработать ответ. Пример показывает максимально упрощённый запрос — только ваш ключ API, данные файла и необязательный список типов элементов для очистки — подтверждая обещание API «один простой вызов».

Документы

Параметры

format: Имя операции, возможные значения: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
AppRequest.OperationTables: Имя операции, возможные значения: clearAll, clearHyperlinks, clearTables, clearPictures, clearShapes, clearComments, clearCharts, clearOleObjects, clearTextboxes, clearScenarios
UploadFileRequest.OperationId: Это идентификатор операции
UploadFileRequest.Files: Это файлы, которые нужно загрузить в наш онлайн‑сервис; вы можете подготовить данные любым способом, но они должны соответствовать стандарту HTML‑элемента input type="file".

Использовать конечные точки

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

curl -X 'POST' \ 'https://api.sheetize.cloud/clear' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.OperationTables=clearHyperlinks' \ -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'
Вы получите файл и сможете либо использовать его, либо просто передать на следующий шаг вашего рабочего процесса.