Compress

Chào mừng bạn đến với tài liệu chính thức cho Compress, API nhẹ nhưng mạnh mẽ được thiết kế để thu nhỏ các tệp bảng tính xuống một phần rất nhỏ so với kích thước ban đầu chỉ bằng một yêu cầu đơn giản, trực quan. Trong thế giới ngày nay dựa vào dữ liệu, các đội ngũ liên tục trao đổi bảng tính chứa mọi thứ từ danh sách đơn giản đến các mô hình tài chính phức tạp, và khối lượng lớn các tệp này nhanh chóng trở thành chi phí ẩn—tải lên chậm hơn, phí lưu trữ tăng, và thời gian xử lý lâu hơn cho các hệ thống downstream. Compress giải quyết những vấn đề này bằng cách cung cấp dịch vụ đám mây thông minh, phân tích cấu trúc nội bộ của bảng tính, loại bỏ các phần không cần thiết và đóng gói lại nội dung thành dạng tối ưu, gọn gàng mà không làm giảm tính toàn vẹn hay khả năng đọc dữ liệu. Trang tài liệu này là nguồn sự thật duy nhất, hướng dẫn bạn mọi điều cần biết để bắt đầu sử dụng API một cách hiệu quả, từ xác thực và định dạng yêu cầu đến xử lý lỗi và các chiến lược thực hành tốt nhất cho xử lý hàng loạt. Dù bạn là kỹ sư backend dày dặn kinh nghiệm tích hợp các pipeline dữ liệu, nhà phát triển front‑end muốn cải thiện trải nghiệm người dùng khi tải tệp lên, hay quản trị viên IT chịu trách nhiệm giảm tải lưu trữ cho toàn tổ chức, hướng dẫn này sẽ cung cấp các hướng dẫn rõ ràng, theo từng bước, đoạn mã mẫu bằng nhiều ngôn ngữ và các ví dụ thực tiễn minh họa cách đạt được kết quả nén tốt nhất cho đa dạng định dạng bảng tính. Trong suốt tài liệu bạn sẽ tìm thấy các phần chuyên đề về bảo mật—như mã hoá TLS, token JWT đã ký, và xử lý dữ liệu tuân thủ GDPR—cùng với các chỉ số hiệu năng cho thấy độ trễ và thông lượng điển hình dưới các tải công việc khác nhau. Chúng tôi cũng bao gồm một phần Câu hỏi thường gặp (FAQ) rộng rãi, ma trận khắc phục sự cố để chẩn đoán nhanh các vấn đề, và liên kết tới các diễn đàn cộng đồng nơi bạn có thể chia sẻ kiến thức với những nhà phát triển khác đang sử dụng Compress trong môi trường thực tế. Khi kết thúc hướng dẫn, bạn sẽ tự tin cấu hình môi trường, gửi một lời gọi API đúng định dạng, và giải mã các payload phản hồi, giúp bạn nhúng nén dữ liệu vào quy trình làm việc hiện có một cách liền mạch và nhanh chóng nhìn thấy tiết kiệm thực tế về chi phí lưu trữ và băng thông mạng. Hãy khám phá, tìm hiểu các phần phù hợp với vai trò của bạn, và để Compress gánh vác công việc nặng nhọc của việc giảm dữ liệu, để bạn có thể tập trung xây dựng các ứng dụng phong phú, đáp ứng nhanh hơn.

Các tính năng chính

Bản chất của API Compress xoay quanh một bộ tính năng phong phú giúp việc giảm kích thước bảng tính trở nên dễ dàng và đáng tin cậy. Trước hết, dịch vụ hỗ trợ đa dạng các loại tệp — bao gồm Apple Numbers, các tệp CSV và TSV đơn giản, cũng như các định dạng .xlsx và .xls của Microsoft Excel — vì vậy bạn có thể gửi hầu hết mọi bảng tính mà không cần bước chuyển đổi trước. Bên trong, engine thực hiện tối ưu hoá đa giai đoạn: chuẩn hoá cấu trúc XML hoặc nhị phân nội bộ của tệp, loại bỏ các kiểu lặp lại, gộp các định dạng ô giống nhau, xóa các hàng và cột ẩn không có dữ liệu, và nén các đối tượng nhúng như hình ảnh, biểu đồ và bảng pivot bằng các thuật toán nén không mất dữ liệu được tùy chỉnh cho từng loại. Ngoài ra, API phát hiện và loại bỏ siêu dữ liệu, bình luận và thông tin phiên bản dư thừa, thường làm tăng kích thước tệp mà hiếm khi có giá trị thực tế. Tất cả các thao tác này diễn ra theo thời gian thực, cung cấp kết quả trong mili giây cho các tệp lên tới 50 MB và mở rộng mượt mà cho các tài liệu lớn hơn với cơ chế throttling và callback tiến độ. Bảo mật được tích hợp sẵn — mỗi yêu cầu được truyền qua HTTPS và dịch vụ không lưu trữ bản sao nào của tệp sau khoảng thời gian xử lý ngắn, đảm bảo tuân thủ các quy định bảo mật nghiêm ngặt. Đối với nhà phát triển, API được thiết kế càng ít ma sát càng tốt: một lần POST duy nhất tới endpoint `/compress` với tệp đính kèm dạng multipart/form‑data sẽ trả về một phản hồi JSON chứa URL tải xuống tệp mới, kích thước gốc và kích thước sau nén, và checksum để xác minh. Các tham số tùy chọn cho phép bạn tinh chỉnh mức nén, giữ lại các sheet cụ thể, hoặc whitelist một số đối tượng nhúng nếu cần duy trì độ chính xác đầy đủ cho các ứng dụng downstream. Các SDK toàn diện có sẵn cho Python, Node.js, Java và Go, mỗi SDK cung cấp phương thức gói ngắn gọn — `compressSpreadsheet(filePath, options)` — ẩn đi lớp HTTP hoàn toàn. Tài liệu chi tiết về rate‑limit và các endpoint tải lên hàng loạt cho phép bạn xử lý hàng ngàn tệp mỗi giờ mà không làm quá tải hạ tầng, trong khi logic retry tích hợp và cơ chế back‑off exponential giữ cho pipeline của bạn ổn định trước các gián đoạn mạng tạm thời. Tóm lại, API Compress cung cấp giải pháp nhanh chóng, an toàn và thân thiện với nhà phát triển, giảm footprint lưu trữ bảng tính, tăng tốc truyền tệp và đơn giản hoá các quy trình quản lý dữ liệu chỉ bằng một lời gọi đơn giản.

Tài liệu

Tham số

AppRequest.CompressionLevel: Mức nén từ một đến chín (1 đến 9)
UploadFileRequest.OperationId: Đây là một ID thao tác
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 riêng của mình nhưng phải tuân theo 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 Compress

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
Dịch vụ sẽ phản hồi với một 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 đơn giản chuyển tiếp nó đến bước tiếp theo trong quy trình làm việc của bạn.