Konverzia

Metadata API je špeciálne vytvorená, vývojársky prívetivá služba, ktorá vám jedinou HTTP požiadavkou poskytuje úplnú kontrolu nad metadátami tabuľkových súborov. Či už pracujete s klasickými kancelárskymi formátmi, ako je Excel (.xlsx, .xls), jednoduchými oddelenými súbormi ako CSV (.csv) a TSV (.tsv), alebo dokonca dokumentmi Apple Numbers (.numbers), API abstrahuje zložitosť a umožní vám čítať, pridávať alebo upravovať kľúčové opisné vlastnosti za milisekundy. Predstavte si, že môžete hromadne spracovať tisíce správ, výskumných dátových súborov alebo finančných výkazov, pričom obohatíte každý súbor o konzistentnú sadu informácií o autorovi, názvy, predmety, popisy, zoznamy kľúčových slov a dokonca aj vlastné kolekcie značiek, ktoré definujete vo svojej aplikácii. Táto úroveň automatizácie nielenže ušetrí nespočetné hodiny manuálneho editovania, ale aj garantuje, že každý súbor, ktorý odosielate klientom, spolupracovníkom alebo archivačným systémom, nesie presné metadáta potrebné pre indexovanie, súlad a objaviteľnosť. Služba funguje tak, že akceptuje buď surové bajty súboru alebo URL odkazujúce na cloud‑hostovaný dokument, a potom vracia nový, kompletný súbor s aplikovanými požadovanými zmenami metadát, pričom nemení pôvodné rozloženie dát ani vzorce.

Hlavné funkcie

Pretože je API bezstavové, môžete ho jednoducho integrovať do CI/CD pipelineov, serverových dávkových úloh alebo klientských JavaScript widgetov, aby každý export z webovej aplikácie alebo každá periodická záloha obsahovali správne informácie o pôvode. Bezpečnosť je vstavaná: všetky volania prebiehajú cez TLS, náklady sú šifrované end‑to‑end a API podporuje autentifikáciu pomocou API‑kľúča alebo OAuth 2.0, čo vám umožňuje obmedziť prístup len na dôveryhodné služby. Základný motor využíva vysoko optimalizované knižnice na parsovanie pre každý podporovaný formát, čo zaručuje, že aj masívne Excel zošity so stotinami hárkov sa spracujú rýchlo; väčšina typických požiadaviek je dokončená za menej ako 200 ms. V praxi to znamená, že môžete vytvoriť plynulé tlačidlo „Pridať metadáta“ vo svojom produkte, ktoré pošle súbor do služby, prijme obohatenú verziu a ponúkne okamžité stiahnutie — všetko bez toho, aby používateľ opustil rozhranie. API tiež vracia podrobné logy operácií, takže vývojári môžu programovo overiť, že očakávané polia boli aktualizované, v prípade potreby vrátiť zmeny späť, alebo spustiť ďalšie spracovateľské kroky na základe hodnôt vlastných značiek. Poskytnutím jednotného, jazykovo nezávislého REST koncového bodu, Metadata API eliminuje potrebu vývojárov udržiavať viacero knižníc špecifických pre formáty, znižuje náklady na údržbu a zabezpečuje budúcu kompatibilitu, keď sa objavia nové štandardy tabuľkových dokumentov. Či už ste SaaS poskytovateľ, ktorý chce vložiť licenčné informácie, výskumná inštitúcia katalogizujúca dátové sady, alebo firma automatizujúca súlad dokumentov, toto API ponúka rýchly, bezpečný a škálovateľný spôsob, ako obohatiť vaše súbory jedným jednoduchým volaním.

Dokumenty

Parametre

AppRequest.Metadata: S PropertyName a PropertyValue
AppRequest.MetadataJson: Ak nepoužívate štruktúru Metadata, musíte použiť typ dát json.
UploadFileRequest.OperationId: Ide o súbory, ktoré je potrebné nahrať do našich online služieb; môžete si dáta pripraviť vlastným spôsobom, ale musia spĺňať štandard vstupného html súboru.
UploadFileRequest.Files: Ide o súbory, ktoré je potrebné nahrať do našich online služieb; môžete si dáta pripraviť vlastným spôsobom, ale musia spĺňať štandard vstupného html súboru.

Použite koncový bod

Pošlite požiadavku, ktorá obsahuje súbory a prí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 odpovie URL na stiahnutie spracovaného súboru, v tomto príklade je to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Pošlite požiadavku, ktorá obsahuje názov súboru a názov priečinka do Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Obdržíte súbor a môžete ho buď použiť, alebo jednoducho poslať ďalej na ďalší krok vášho pracovného postupu.