Преобразование

API метаданных — специально созданный, удобный для разработчиков сервис, который предоставляет полный контроль над метаданными файлов электронных таблиц с помощью одного HTTP‑запроса. Независимо от того, работаете ли вы с классическими офисными форматами, такими как Excel (.xlsx, .xls), простыми разделёнными файлами, как CSV (.csv) и TSV (.tsv), или даже документами Apple Numbers (.numbers), API абстрагирует сложность разбора файлов и позволяет читать, добавлять или изменять ключевые описательные свойства за миллисекунды. Представьте возможность пакетно обрабатывать тысячи отчётов, наборов исследовательских данных или финансовых отчётов, обогащая каждый файл единым набором информации об авторе, названий, тем, описаний, списков ключевых слов и даже пользовательских коллекций тегов, определяемых вашим приложением. Такой уровень автоматизации не только экономит бесчисленные часы ручного редактирования, но и гарантирует, что каждый файл, отправляемый клиентам, коллегам или в архивные системы, содержит точные метаданные, необходимые для индексации, соответствия требованиям и обнаруживаемости. Сервис принимает либо необработанные байты файла, либо URL, указывающий на документ в облаке, и возвращает новый полностью сформированный файл с применёнными изменениями метаданных без изменения исходного макета данных или формул.

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

Поскольку API без состояния, вы можете легко интегрировать его в CI/CD конвейеры, серверные пакетные задания или клиентские JavaScript‑виджеты, гарантируя, что каждый экспорт из веб‑приложения или каждое периодическое резервное копирование содержит правильную информацию о происхождении. Безопасность встроена: все вызовы выполняются по TLS, полезные нагрузки шифруются end‑to‑end, а API поддерживает аутентификацию по API‑key или OAuth 2.0, позволяя ограничить доступ только доверенными сервисами. Подлежащий движок использует высокооптимизированные библиотеки разбора для каждого поддерживаемого формата, гарантируя, что даже массивные рабочие книги Excel со сотнями листов обрабатываются быстро; большинство типовых запросов завершаются менее чем за 200 мс. На практике это означает, что вы можете создать бесшовную кнопку «Добавить метаданные» в вашем продукте, которая отправляет файл в сервис, получает обогащённую версию и предлагает её для мгновенного скачивания — без выхода пользователя из интерфейса. API также возвращает подробные журналы операций, чтобы разработчики могли программно проверять, что ожидаемые поля обновлены, откатывать изменения при необходимости или инициировать дальнейшие шаги обработки на основе значений пользовательских тегов. Предоставляя единый, язык‑независимый REST‑конечный пункт, API метаданных избавляет разработчиков от необходимости поддерживать несколько библиотек, специфичных для форматов, снижает нагрузку на обслуживание и обеспечивает совместимость с будущими версиями, когда появляются новые стандарты таблиц. Независимо от того, являетесь ли вы SaaS‑провайдером, желающим встроить информацию о лицензировании, исследовательским институтом, каталогизирующим наборы данных, или корпорацией, автоматизирующей соблюдение документальных требований, этот API предлагает быстрый, безопасный и масштабируемый способ обогатить ваши файлы одним простым вызовом.

Документы

Параметры

AppRequest.Metadata: С PropertyName и PropertyValue
AppRequest.MetadataJson: Если вы не используете структуру Metadata, то необходимо использовать тип данных json.
UploadFileRequest.OperationId: Это файлы, которые необходимо загрузить в наш онлайн‑сервис; вы можете подготовить данные любым способом, но они должны соответствовать стандарту HTML‑input файл.
UploadFileRequest.Files: Это файлы, которые необходимо загрузить в наш онлайн‑сервис; вы можете подготовить данные любым способом, но они должны соответствовать стандарту HTML‑input файл.

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

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

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