Conversione

L'API Metadata è un servizio progettato su misura per gli sviluppatori che mette il controllo completo sui metadati dei file di foglio di calcolo a portata di mano con una singola richiesta HTTP. Che tu stia lavorando con formati di office tradizionali come Excel (.xlsx, .xls), file delimitati semplici come CSV (.csv) e TSV (.tsv), oppure documenti Apple Numbers (.numbers), l'API astrae le complessità dell'analisi dei file e ti consente di leggere, aggiungere o modificare le proprietà descrittive chiave in pochi millisecondi. Immagina di poter elaborare in batch migliaia di report, set di dati di ricerca o bilanci finanziari, arricchendo ogni file con un set coerente di informazioni sull'autore, titoli, soggetti, descrizioni, elenchi di parole chiave e persino collezioni di tag personalizzati definite dalla tua applicazione. Questo livello di automazione non solo fa risparmiare ore incontabili di editing manuale, ma garantisce anche che ogni file che distribuisci a clienti, collaboratori o sistemi di archiviazione contenga esattamente i metadati necessari per indicizzazione, conformità e reperibilità. Il servizio accetta sia i byte grezzi del file sia un URL che punta a un documento ospitato nel cloud, quindi restituisce un nuovo file completamente formato con le modifiche ai metadati richieste applicate senza alterare il layout originale dei dati o le formule.

Caratteristiche Principali

Poiché l'API è senza stato, puoi integrarla facilmente nei pipeline CI/CD, nei job batch lato server o nei widget JavaScript lato client, garantendo che ogni esportazione da un'app web o ogni backup periodico contenga le informazioni di provenienza corrette. La sicurezza è incorporata: tutte le chiamate avvengono su TLS, i payload sono crittografati end‑to‑end e l'API supporta l'autenticazione tramite API‑key o OAuth 2.0, permettendoti di limitare l'accesso ai soli servizi fidati. Il motore sottostante utilizza librerie di parsing altamente ottimizzate per ogni formato supportato, garantendo che anche cartelle di lavoro Excel massive con centinaia di fogli vengano processate rapidamente; la maggior parte delle richieste tipiche si completa in meno di 200 ms. In pratica, questo significa che puoi creare un pulsante “Aggiungi Metadati” fluido all'interno del tuo prodotto che invia il file al servizio, riceve la versione arricchita e la offre per il download immediato—tutto senza che l'utente lasci l'interfaccia. L'API restituisce anche log operativi dettagliati, così gli sviluppatori possono verificare programmaticamente che i campi attesi siano stati aggiornati, annullare le modifiche se necessario o avviare ulteriori passaggi di elaborazione basati sui valori dei tag personalizzati. Fornendo un endpoint REST uniforme e indipendente dal linguaggio, l'API Metadata elimina la necessità per gli sviluppatori di mantenere librerie specifiche per ogni formato, riduce l'overhead di manutenzione e assicura compatibilità futura man mano che emergono nuovi standard di foglio di calcolo. Che tu sia un fornitore SaaS che desidera incorporare informazioni di licenza, un'istituzione di ricerca che cataloghi set di dati, o un'impresa che automizzi la conformità documentale, questa API offre un modo rapido, sicuro e scalabile per arricchire i tuoi file con una singola chiamata semplice.

Documenti

Parametri

AppRequest.Metadata: Con PropertyName e PropertyValue
AppRequest.MetadataJson: Se non stai usando la struttura Metadata, devi utilizzare il tipo di dato JSON.
UploadFileRequest.OperationId: Questi sono file che devi caricare sui nostri servizi online, puoi preparare i dati come preferisci, ma devono rispettare lo standard dell'input file HTML.
UploadFileRequest.Files: Questi sono file che devi caricare sui nostri servizi online, puoi preparare i dati come preferisci, ma devono rispettare lo standard dell'input file HTML.

Usa l'Endpoint

Invia una richiesta che includa i file e il token di accesso API Metadata

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'
Il servizio risponderà con un URL di download per il file processato, in questo esempio è:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Invia una richiesta che includa il nome del file e il nome della cartella a API Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Riceverai il file e potrai usarlo oppure semplicemente inoltrarlo al passo successivo del tuo flusso di lavoro.