Konvertierung

Die Metadata‑API ist ein speziell entwickelter, entwicklerfreundlicher Service, der Ihnen mit nur einer einzigen HTTP‑Anfrage die vollständige Kontrolle über Metadaten von Tabellenkalkulationsdateien in die Hand gibt. Ob Sie mit klassischen Office‑Formaten wie Excel (.xlsx, .xls), einfachen, durch Trennzeichen getrennten Dateien wie CSV (.csv) und TSV (.tsv) oder sogar Apple‑Numbers‑Dokumenten (.numbers) arbeiten – die API verbirgt die Komplexität des Datei‑Parsings und ermöglicht es Ihnen, Schlüssel‑Deskriptiveigenschaften innerhalb von Millisekunden zu lesen, hinzuzufügen oder zu ändern. Stellen Sie sich vor, Sie könnten Tausende von Berichten, Forschungsdatensätzen oder Finanzberichten stapelweise verarbeiten und jede Datei mit einem konsistenten Satz an Autoreninformationen, Titeln, Themen, Beschreibungen, Schlüsselwortlisten und sogar benutzerdefinierten Tag‑Sammlungen, die Ihre Anwendung definiert, anreichern. Dieses Automatisierungs‑Level spart nicht nur unzählige Stunden manueller Bearbeitung, sondern stellt auch sicher, dass jede Datei, die Sie an Kunden, Partner oder Archivsysteme senden, exakt die Metadaten für Indexierung, Compliance und Auffindbarkeit enthält, die Sie benötigen. Der Service akzeptiert entweder die rohen Dateibytes oder eine URL, die auf ein cloud‑gehostetes Dokument verweist, und gibt anschließend eine neue, vollständig‑geformte Datei mit den gewünschten Metadatenänderungen zurück, ohne das ursprüngliche Datenlayout oder Formeln zu verändern.

Hauptfunktionen

Da die API zustandslos ist, können Sie sie problemlos in CI/CD‑Pipelines, serverseitige Batch‑Jobs oder clientseitige JavaScript‑Widgets integrieren, sodass jeder Export aus einer Web‑App oder jede periodische Sicherung die korrekten Provenienz‑Informationen enthält. Sicherheit ist von Grund auf eingebaut: Alle Aufrufe erfolgen über TLS, die Nutzdaten werden Ende‑zu‑Ende verschlüsselt und die API unterstützt Authentifizierung per API‑Key oder OAuth 2.0, sodass Sie den Zugriff nur auf vertrauenswürdige Dienste beschränken können. Die zugrunde liegende Engine nutzt hochoptimierte Parsing‑Bibliotheken für jedes unterstützte Format und garantiert, dass selbst massive Excel‑Arbeitsmappen mit Hunderten von Tabellenblättern schnell verarbeitet werden; die meisten typischen Anfragen schließen in unter 200 ms ab. In der Praxis bedeutet das, dass Sie in Ihrem Produkt einen nahtlosen „Metadaten hinzufügen“-Button einbauen können, der die Datei an den Service sendet, die angereicherte Version zurückerhält und sofort zum Download anbietet – ohne dass der Nutzer die Oberfläche verlässt. Die API liefert zudem detaillierte Operations‑Logs, sodass Entwickler programmgesteuert prüfen können, ob die erwarteten Felder aktualisiert wurden, Änderungen bei Bedarf zurückrollen oder weitere Verarbeitungsschritte basierend auf benutzerdefinierten Tag‑Werten auslösen können. Durch einen einheitlichen, sprachunabhängigen REST‑Endpunkt eliminiert die Metadata‑API den Bedarf, mehrere format‑spezifische Bibliotheken zu pflegen, reduziert Wartungsaufwand und gewährleistet zukunftssichere Kompatibilität, wenn neue Tabellen‑Standards erscheinen. Egal, ob Sie ein SaaS‑Anbieter sind, der Lizenzinformationen einbetten möchte, eine Forschungseinrichtung, die Datensätze katalogisiert, oder ein Unternehmen, das Dokumenten‑Compliance automatisiert – diese API bietet eine schnelle, sichere und skalierbare Möglichkeit, Ihre Dateien mit einem einzigen Aufruf zu bereichern.

Dokumente

Parameter

AppRequest.Metadata: Mit PropertyName und PropertyValue
AppRequest.MetadataJson: Wenn Sie die Metadatenstruktur nicht verwenden, müssen Sie den JSON‑Datentyp verwenden.
UploadFileRequest.OperationId: Dies sind Dateien, die Sie in unseren Online‑Service hochladen müssen; Sie können die Daten nach eigenem Ermessen vorbereiten, sie müssen jedoch dem Standard des HTML‑Datei‑Inputs entsprechen.
UploadFileRequest.Files: Dies sind Dateien, die Sie in unseren Online‑Service hochladen müssen; Sie können die Daten nach eigenem Ermessen vorbereiten, sie müssen jedoch dem Standard des HTML‑Datei‑Inputs entsprechen.

Endpunkt verwenden

Senden Sie eine Anfrage, die die Dateien und das Zugriffstoken enthält. 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'
Der Dienst antwortet mit einer Download‑URL für die verarbeitete Datei, in diesem Beispiel ist sie:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Senden Sie eine Anfrage, die den Dateinamen und den Ordnernamen enthält, zu Download‑API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Sie erhalten die Datei und können sie entweder verwenden oder einfach zum nächsten Schritt Ihres Workflows weiterleiten.