Конвертація

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

Основні можливості

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

Документи

Параметри

AppRequest.Metadata: З PropertyName і PropertyValue
AppRequest.MetadataJson: Якщо ви не використовуєте структуру Metadata, потрібно застосовувати тип даних json.
UploadFileRequest.OperationId: Це файли, які потрібно завантажити до наших онлайн‑сервісів; ви можете підготувати дані у власному вигляді, проте вони мають відповідати стандарту HTML‑виводу файлу.
UploadFileRequest.Files: Це файли, які потрібно завантажити до наших онлайн‑сервісів; ви можете підготувати дані у власному вигляді, проте вони мають відповідати стандарту HTML‑виводу файлу.

Використовуйте кінцеву точку

Надішліть запит, що містить файли та токен доступу Metadata 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 }
Надішліть запит, що містить назву файлу та назву папки до Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Ви отримаєте файл і зможете або використати його, або просто передати на наступний крок вашого робочого процесу.