Konwersja

API Metadanych to specjalnie stworzone, przyjazne dla deweloperów rozwiązanie, które daje pełną kontrolę nad metadanymi plików arkuszy kalkulacyjnych na wyciągnięcie ręki przy użyciu jednego żądania HTTP. Niezależnie od tego, czy pracujesz z klasycznymi formatami biurowymi takimi jak Excel (.xlsx, .xls), prostymi plikami rozdzielonymi jak CSV (.csv) i TSV (.tsv), czy też dokumentami Apple Numbers (.numbers), API ukrywa złożoność parsowania plików i pozwala odczytywać, dodawać lub modyfikować kluczowe właściwości opisowe w ciągu kilku milisekund. Wyobraź sobie możliwość przetwarzania wsadowego tysięcy raportów, zestawów danych badawczych lub sprawozdań finansowych, wzbogacając każdy plik o spójną grupę informacji o autorze, tytuły, tematy, opisy, listy słów kluczowych oraz nawet niestandardowe kolekcje tagów definiowane przez Twoją aplikację. Taki poziom automatyzacji nie tylko oszczędza niezliczone godziny ręcznej edycji, ale także gwarantuje, że każdy plik wysyłany do klientów, współpracowników lub systemów archiwizacyjnych zawiera dokładne metadane niezbędne do indeksowania, zgodności i wyszukiwalności. Usługa działa, przyjmując albo surowe bajty pliku, albo URL wskazujący na dokument hostowany w chmurze, a następnie zwraca nowy, w pełni sformatowany plik z zastosowanymi zmianami metadanych, nie modyfikując oryginalnego układu danych ani formuł.

Główne funkcje

Ponieważ API jest bezstanowe, możesz łatwo zintegrować je z pipeline’ami CI/CD, zadaniami wsadowymi po stronie serwera lub widgetami JavaScript po stronie klienta, zapewniając, że każdy eksport z aplikacji webowej lub każda okresowa kopia zapasowa zawiera prawidłowe informacje o pochodzeniu. Bezpieczeństwo jest wbudowane: wszystkie wywołania odbywają się przez TLS, ładunki są szyfrowane end‑to‑end, a API obsługuje uwierzytelnianie kluczem API lub OAuth 2.0, co pozwala ograniczyć dostęp wyłącznie do zaufanych usług. Podstawowy silnik wykorzystuje wysoce zoptymalizowane biblioteki parsujące dla każdego obsługiwanego formatu, zapewniając szybkie przetwarzanie nawet ogromnych skoroszytów Excel z setkami arkuszy; większość typowych żądań kończy się w czasie krótszym niż 200 ms. W praktyce oznacza to, że możesz stworzyć płynny przycisk „Dodaj metadane” w swoim produkcie, który wysyła plik do usługi, otrzymuje wzbogaconą wersję i udostępnia ją do natychmiastowego pobrania — bez opuszczania interfejsu przez użytkownika. API zwraca również szczegółowe logi operacji, dzięki czemu programiści mogą programowo weryfikować, że oczekiwane pola zostały zaktualizowane, cofnąć zmiany w razie potrzeby lub wyzwolić dalsze kroki przetwarzania w oparciu o wartości niestandardowych tagów. Udostępniając jednolity, niezależny od języka punkt końcowy REST, API Metadanych eliminuje potrzebę utrzymywania przez programistów wielu bibliotek specyficznych dla formatów, zmniejsza obciążenie konserwacyjne i zapewnia przyszłościową kompatybilność w miarę pojawiania się nowych standardów arkuszy kalkulacyjnych. Niezależnie od tego, czy jesteś dostawcą SaaS chcącym wbudować informacje licencyjne, instytucją badawczą katalogującą zestawy danych, czy przedsiębiorstwem automatyzującym zgodność dokumentów, to API oferuje szybki, bezpieczny i skalowalny sposób na wzbogacenie plików jednym prostym wywołaniem.

Dokumenty

Parametry

AppRequest.Metadata: Z PropertyName i PropertyValue
AppRequest.MetadataJson: Jeśli nie używasz struktury Metadata, musisz użyć typu danych json.
UploadFileRequest.OperationId: Są to pliki, które musisz przesłać do naszych usług online; możesz przygotować dane w dowolny sposób, ale muszą one spełniać standard pola wejściowego HTML.
UploadFileRequest.Files: Są to pliki, które musisz przesłać do naszych usług online; możesz przygotować dane w dowolny sposób, ale muszą one spełniać standard pola wejściowego HTML.

Użyj punktu końcowego

Wyślij żądanie zawierające pliki oraz token dostępu API Metadanych

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'
Usługa zwróci URL do pobrania przetworzonego pliku, w tym przykładzie jest to:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Wyślij żądanie zawierające nazwę pliku oraz nazwę folderu do API Pobierania

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Otrzymasz plik i możesz go użyć lub po prostu przekazać do następnego kroku swojego przepływu pracy.