Chuyển đổi

API Metadata là một dịch vụ được thiết kế riêng, thân thiện với nhà phát triển, cho phép bạn kiểm soát hoàn toàn siêu dữ liệu của các tệp bảng tính chỉ bằng một yêu cầu HTTP duy nhất. Cho dù bạn đang làm việc với các định dạng văn phòng truyền thống như Excel (.xlsx, .xls), các tệp phân tách đơn giản như CSV (.csv) và TSV (.tsv), hoặc thậm chí các tài liệu Apple Numbers (.numbers), API trừu tượng hóa các phức tạp của việc phân tích tệp và cho phép bạn đọc, thêm hoặc sửa đổi các thuộc tính mô tả chính trong vòng vài mili giây. Hãy tưởng tượng bạn có thể batch‑process hàng ngàn báo cáo, bộ dữ liệu nghiên cứu, hoặc báo cáo tài chính, làm giàu mỗi tệp với một bộ thông tin tác giả, tiêu đề, chủ đề, mô tả, danh sách từ khóa và thậm chí các bộ thẻ tùy chỉnh mà ứng dụng của bạn định nghĩa. Mức độ tự động hoá này không chỉ tiết kiệm vô số giờ chỉnh sửa thủ công mà còn đảm bảo rằng mỗi tệp bạn cung cấp cho khách hàng, cộng sự hoặc hệ thống lưu trữ đều mang theo siêu dữ liệu chính xác cần thiết cho việc lập chỉ mục, tuân thủ và khả năng khám phá. Dịch vụ hoạt động bằng cách chấp nhận either raw file bytes hoặc một URL trỏ tới tài liệu trên đám mây, sau đó trả về một tệp mới đã được áp dụng các thay đổi siêu dữ liệu yêu cầu mà không làm thay đổi bố cục dữ liệu gốc hay công thức.

Tính năng chính

Vì API không trạng thái, bạn có thể dễ dàng tích hợp nó vào các pipeline CI/CD, các công việc batch phía máy chủ, hoặc các widget JavaScript phía client, đảm bảo rằng mỗi lần xuất từ một ứng dụng web hoặc mỗi bản sao lưu định kỳ đều chứa thông tin nguồn gốc chính xác. Bảo mật được tích hợp sẵn: tất cả các cuộc gọi đều thực hiện qua TLS, payload được mã hoá end‑to‑end, và API hỗ trợ xác thực bằng API‑key hoặc OAuth 2.0, cho phép bạn giới hạn quyền truy cập chỉ cho các dịch vụ đáng tin cậy. Động cơ nền tảng tận dụng các thư viện phân tích được tối ưu cao cho mỗi định dạng được hỗ trợ, bảo đảm ngay cả những workbook Excel khổng lồ với hàng trăm sheet cũng được xử lý nhanh; hầu hết các yêu cầu thông thường hoàn thành dưới 200 ms. Thực tế, bạn có thể xây dựng một nút “Thêm Siêu dữ liệu” liền mạch trong sản phẩm, gửi tệp tới dịch vụ, nhận lại phiên bản đã được làm giàu và cung cấp ngay cho người dùng tải xuống — mà không cần rời khỏi giao diện. API cũng trả về nhật ký vận hành chi tiết, cho phép các nhà phát triển kiểm tra programmatically rằng các trường mong muốn đã được cập nhật, hoàn tác thay đổi nếu cần, hoặc kích hoạt các bước xử lý tiếp theo dựa trên giá trị thẻ tùy chỉnh. Bằng cách cung cấp một endpoint REST đồng nhất, ngôn ngữ‑không‑phụ thuộc, API Metadata loại bỏ nhu cầu duy trì nhiều thư viện định dạng riêng biệt, giảm gánh nặng bảo trì và đảm bảo khả năng tương thích trong tương lai khi các tiêu chuẩn bảng tính mới xuất hiện. Dù bạn là nhà cung cấp SaaS muốn nhúng thông tin cấp phép, tổ chức nghiên cứu catalog các bộ dữ liệu, hay doanh nghiệp tự động hoá tuân thủ tài liệu, API này cung cấp cách nhanh, an toàn và mở rộng để làm giàu tệp của bạn chỉ với một lời gọi đơn giản.

Tài liệu

Tham số

AppRequest.Metadata: Với PropertyName và PropertyValue
AppRequest.MetadataJson: Nếu bạn không sử dụng cấu trúc Metadata thì phải sử dụng kiểu dữ liệu JSON.
UploadFileRequest.OperationId: Đây là các tệp bạn cần tải lên dịch vụ trực tuyến của chúng tôi, bạn có thể chuẩn bị dữ liệu theo cách của mình nhưng phải tuân theo tiêu chuẩn của thẻ input file HTML.
UploadFileRequest.Files: Đây là các tệp bạn cần tải lên dịch vụ trực tuyến của chúng tôi, bạn có thể chuẩn bị dữ liệu theo cách của mình nhưng phải tuân theo tiêu chuẩn của thẻ input file HTML.

Sử dụng endpoint

Gửi một yêu cầu bao gồm các tệp và token truy cập 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'
Dịch vụ sẽ trả về URL tải xuống cho tệp đã xử lý, trong ví dụ này là:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Gửi một yêu cầu bao gồm tên tệp và tên thư mục tới API Tải xuống

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Bạn sẽ nhận được tệp và có thể sử dụng nó hoặc chuyển tiếp nó tới bước tiếp theo của quy trình làm việc.