Replace

Добро пожаловать в документацию API Replace — упрощённое решение для преобразования содержимого ваших табличных файлов одним мощным вызовом. Независимо от того, работаете ли вы с повсеместными форматами Excel (.xlsx, .xls, .xlsm), простыми файлами CSV и TSV или документами Apple Numbers (.numbers), наш API понимает их все и предоставляет единый интерфейс для точных замен текста. Задавая чёткие условия равенства, вы можете точно указать, какие ячейки следует изменить, и предоставить новые значения, устраняя догадки и ручные усилия, часто сопутствующие массовому редактированию данных. Это делает API идеальным помощником для задач, таких как очистка данных, где необходимо исправлять повторяющиеся ошибки в больших наборах, или проекты локализации, требующие систематической замены терминов по языкам. Философия дизайна Replace заключается в том, чтобы процесс был быстрым, безопасным и удобным для разработчиков, позволяя интегрировать изменения таблиц в существующие рабочие процессы без потери производительности или безопасности.

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

Помимо основных возможностей замены, API Replace разработан для решения практических задач современной обработки данных. По возможности он обрабатывает файлы в памяти, уменьшая необходимость в промежуточном хранении и ускоряя операции даже на больших таблицах. Надёжная аутентификация и зашифрованная передача гарантируют защиту ваших конфиденциальных данных на протяжении всей транзакции. Структура ответа API предоставляет чёткую обратную связь о том, какие ячейки были изменены, сколько замен выполнено и какие строки не соответствовали заданным условиям, обеспечивая полную видимость процесса преобразования. Независимо от того, очищаете ли вы устаревший набор данных, готовите каталог товаров для нового рынка или просто автоматизируете повторяющиеся обновления таблиц, этот API даёт уверенность в надёжном переоформлении данных с минимальным кодом и максимальным контролем.

Документы

Параметры

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

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

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

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