Konverze

Metadata API je speciálně vytvořená, vývojáři přívětivá služba, která vám jedním HTTP požadavkem dává úplnou kontrolu nad metadaty souborů tabulek. Ať už pracujete s klasickými formáty kancelářských aplikací, jako je Excel (.xlsx, .xls), jednoduchými oddělenými soubory jako CSV (.csv) a TSV (.tsv), nebo dokonce s dokumenty Apple Numbers (.numbers), API abstrahuje složitosti parsování souborů a umožňuje vám číst, přidávat či měnit klíčové popisné vlastnosti během milisekund. Představte si možnost dávkově zpracovat tisíce zpráv, výzkumných datových sad nebo finančních výkazů, obohacovat každý soubor konzistentní sadou informací o autorovi, názvech, předmětech, popisech, seznamech klíčových slov a dokonce i vlastními kolekcemi značek, které definuje vaše aplikace. Tato úroveň automatizace nejen šetří nespočet hodin ruční úpravy, ale také zaručuje, že každý soubor, který odešlete klientům, spolupracovníkům nebo archivním systémům, nese přesně ta metadata, která potřebujete pro indexování, soulad a objevnitelnost. Služba funguje tak, že přijímá buď surové bajty souboru, nebo URL odkazující na cloudově hostovaný dokument, a následně vrací nový, plně vytvořený soubor s požadovanými změnami metadat, aniž by měnila původní rozvržení dat či vzorce.

Hlavní funkce

Protože je API bezstavové, můžete jej snadno integrovat do CI/CD pipeline, dávkových úloh na serveru nebo widgetů JavaScriptu na klientovi, což zajišťuje, že každý export z webové aplikace nebo každá periodická záloha obsahuje správné informace o původu. Bezpečnost je součástí: všechny volání probíhají přes TLS, payloady jsou šifrovány end‑to‑end a API podporuje autentizaci pomocí API klíče nebo OAuth 2.0, což vám umožní omezit přístup jen na důvěryhodné služby. Podkladový motor využívá vysoce optimalizované knihovny pro parsování každého podporovaného formátu, což zaručuje, že i obrovské sešity Excelu se stovkami listů jsou zpracovány rychle; většina běžných požadavků je dokončena za méně než 200 ms. V praxi to znamená, že můžete vytvořit plynulé tlačítko „Přidat metadata“ ve svém produktu, které odešle soubor službě, získá obohacenou verzi a nabídne ji k okamžitému stažení – vše bez opuštění rozhraní uživatele. API také vrací podrobné provozní logy, takže vývojáři mohou programově ověřit, že očekávaná pole byla aktualizována, vrátit změny zpět v případě potřeby nebo spustit další zpracování na základě hodnot vlastních značek. Poskytováním jednotného jazykově neutrálního REST endpointu Metadata API odstraňuje potřebu udržovat více knihoven specifických pro formáty, snižuje údržbové náklady a zajišťuje budoucí kompatibilitu, jak se objevují nové standardy tabulek. Ať už jste SaaS dodavatel, který chce vložit licenční informace, výzkumná instituce katalogizující datové sady, nebo podnik automatizující soulad dokumentů, toto API nabízí rychlý, bezpečný a škálovatelný způsob, jak obohatit soubory jediným jednoduchým voláním.

Dokumenty

Parametry

AppRequest.Metadata: S PropertyName a PropertyValue
AppRequest.MetadataJson: Pokud nepoužíváte strukturu Metadata, musíte použít typ dat json.
UploadFileRequest.OperationId: Jedná se o soubory, které musíte nahrát do našich online služeb; můžete data připravit po svém, ale musí odpovídat standardu vstupního html souboru.
UploadFileRequest.Files: Jedná se o soubory, které musíte nahrát do našich online služeb; můžete data připravit po svém, ale musí odpovídat standardu vstupního html souboru.

Použít endpoint

Pošlete požadavek, který obsahuje soubory a přístupový token 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'
Služba odpoví URL pro stažení zpracovaného souboru, v tomto příkladu je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Pošlete požadavek, který obsahuje název souboru a název složky do Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte soubor a můžete jej buď použít, nebo jej jednoduše předat do dalšího kroku vašeho workflow.