Conversie

De Metadata API is een speciaal gebouwde, ontwikkelaar‑vriendelijke service die volledige controle over spreadsheet‑bestandmetadata binnen handbereik brengt met slechts één HTTP‑verzoek. Of u nu werkt met klassieke kantoorformaten zoals Excel (.xlsx, .xls), eenvoudige gescheiden bestanden zoals CSV (.csv) en TSV (.tsv), of zelfs Apple Numbers‑documenten (.numbers), de API verbergt de complexiteit van bestandsparsen en stelt u in staat sleutel‑beschrijvende eigenschappen te lezen, toe te voegen of te wijzigen binnen enkele milliseconden. Stel u voor dat u duizenden rapporten, onderzoeksdatabases of financiële rapporten in batch kunt verwerken, en elk bestand verrijkt met een consistente set auteurinformatie, titels, onderwerpen, beschrijvingen, trefwoordenlijsten en zelfs aangepaste tag‑collecties die uw eigen applicatie definieert. Dit automatiseringsniveau bespaart niet alleen ontelbare uren handmatig bewerken, maar garandeert ook dat elk bestand dat u naar klanten, samenwerkers of archiveringssystemen verzendt, de exacte metadata bevat die u nodig heeft voor indexering, naleving en vindbaarheid. De service werkt door ofwel de ruwe bestandsbytes of een URL die naar een cloud‑gehost document wijst te accepteren, waarna een nieuw, volledig gevormd bestand wordt geretourneerd met de aangevraagde metadata‑wijzigingen toegepast, zonder de oorspronkelijke gegevenslay‑out of formules te wijzigen.

Hoofdfuncties

Aangezien de API stateless is, kunt u deze eenvoudig integreren in CI/CD‑pipelines, server‑side batch‑taken of client‑side JavaScript‑widgets, waardoor elke export vanuit een webapplicatie of elke periodieke back‑up de juiste herkomstinformatie bevat. Beveiliging is ingebouwd: alle oproepen verlopen via TLS, de payloads zijn end‑to‑end versleuteld, en de API ondersteunt API‑sleutel‑ of OAuth 2.0‑authenticatie, zodat u de toegang kunt beperken tot vertrouwde diensten. De onderliggende engine maakt gebruik van sterk geoptimaliseerde parsingsbibliotheken voor elk ondersteund formaat, waardoor zelfs enorme Excel‑werkboeken met honderden werkbladen snel worden verwerkt; de meeste normale verzoeken worden binnen 200 ms voltooid. In de praktijk betekent dit dat u een naadloze “Metadata toevoegen”-knop in uw product kunt bouwen die het bestand naar de service verzendt, de verrijkte versie ontvangt en direct downloadbaar maakt – zonder dat de gebruiker de interface verlaat. De API retourneert ook gedetailleerde operationele logs, zodat ontwikkelaars programmatisch kunnen verifiëren dat de verwachte velden zijn bijgewerkt, wijzigingen indien nodig kunnen terugdraaien, of verdere verwerkingsstappen kunnen triggeren op basis van aangepaste tag‑waarden. Door een uniform, taal‑agnostisch REST‑endpoint te bieden, elimineert de Metadata API de noodzaak voor ontwikkelaars om meerdere formaat‑specifieke bibliotheken te onderhouden, vermindert het onderhouds‑overhead, en garandeert toekomstbestendige compatibiliteit zodra nieuwe spreadsheet‑standaarden verschijnen. Of u nu een SaaS‑leverancier bent die licentie‑informatie wil integreren, een onderzoeksinstelling die datasets catalogueert, of een onderneming die documentnaleving automatiseert, deze API biedt een snelle, veilige en schaalbare manier om uw bestanden te verrijken met één eenvoudige oproep.

Documenten

Parameters

AppRequest.Metadata: Met PropertyName en PropertyValue
AppRequest.MetadataJson: Als u de Metadata‑structuur niet gebruikt, moet u het JSON‑datatype gebruiken.
UploadFileRequest.OperationId: Dit zijn bestanden die u moet uploaden naar onze online diensten; u kunt de gegevens op uw eigen manier voorbereiden, maar ze moeten voldoen aan de standaard van het HTML‑input‑bestand.
UploadFileRequest.Files: Dit zijn bestanden die u moet uploaden naar onze online diensten; u kunt de gegevens op uw eigen manier voorbereiden, maar ze moeten voldoen aan de standaard van het HTML‑input‑bestand.

Gebruik het endpoint

Stuur een verzoek dat de bestanden en het toegangstoken bevat 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'
De service reageert met een download‑URL voor het verwerkte bestand, in dit voorbeeld is dat:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Stuur een verzoek dat de bestandsnaam en de mapnaam bevat voor Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
U ontvangt het bestand en kunt het gebruiken of eenvoudig doorsturen naar de volgende stap in uw workflow.