So sánh

Chào mừng bạn đến với trung tâm tài liệu chính thức của API So sánh, một giải pháp được thiết kế đặc biệt để biến công việc kiểm soát phiên bản bảng tính thường gây nhàm chán thành quy trình làm việc mượt mà, hướng tới nhà phát triển. Dù bạn là nhà phân tích dữ liệu đang điều chỉnh báo cáo quý, đội ngũ tài chính theo dõi sự điều chỉnh ngân sách, hay kỹ sư phần mềm tích hợp khả năng so sánh vào quy trình dữ liệu lớn hơn, API này được thiết kế để đáp ứng nhu cầu của bạn và loại bỏ sự đoán mò khi phát hiện thay đổi trên nhiều định dạng bảng tính. Về cốt lõi, API So sánh tuân theo mô hình đơn giản nhưng mạnh mẽ: bạn cung cấp hai tệp nguồn—dù chúng đến từ Apple Numbers, xuất CSV/TSV, hoặc bộ Excel .xlsx, .xls phổ biến—và dịch vụ trả về một tệp kết quả duy nhất, nhấn mạnh mọi sự thêm, xóa và sửa đổi bằng các dấu hiệu trực quan rõ ràng. Sự nhấn mạnh vào tính rõ ràng không phải là suy nghĩ sau cùng; mỗi sự khác biệt được chú thích theo cách phản ánh quy ước bản gốc của bảng tính (nền ô màu, bong bóng bình luận và dấu hiệu hàng/cột), giúp người dùng cuối mở kết quả trong ứng dụng yêu thích và ngay lập tức hiểu những gì đã thay đổi. Ngoài việc so sánh cơ bản, API còn giữ nguyên định dạng gốc, công thức và kiểu dữ liệu, đảm bảo kết quả không chỉ là báo cáo văn bản thuần mà là một sổ làm việc đầy đủ chức năng, sẵn sàng cho phân tích hoặc phân phối tiếp. Bảo mật và hiệu năng được tích hợp trong mọi yêu cầu: tất cả việc chuyển tệp diễn ra qua TLS 1.3, các tệp được xử lý trong các container cô lập với giới hạn bộ nhớ chặt chẽ, và kết quả thường được trả về trong vòng dưới một giây cho các tệp lên tới 10 MB, mở rộng linh hoạt cho bộ dữ liệu lớn hơn thông qua truyền dữ liệu theo khối. Tài liệu bạn đang đọc hiện được tổ chức để bạn nhanh chóng khởi động trong vài phút—bắt đầu từ xác thực, tiến tới xây dựng yêu cầu, và kết thúc bằng các mẫu thực hành tốt nhất cho xử lý lỗi, phân trang và tích hợp webhook. Trong suốt tài liệu, bạn sẽ thấy các đoạn mã mẫu bằng Python, JavaScript, Java và C#, minh họa cách một dòng lệnh duy nhất có thể kích hoạt quá trình so sánh toàn diện, cùng môi trường sandbox cho phép bạn thử nghiệm với tệp thực tế mà không rời trình duyệt. Khi kết thúc hướng dẫn này, bạn sẽ nắm vững cách nhúng khả năng so sánh bảng tính chính xác, tin cậy vào bất kỳ quy trình nào, giảm thời gian kiểm tra thủ công và cung cấp cho các bên liên quan các log thay đổi minh bạch, có thể kiểm toán—tất cả đều dựa trên một API vừa an toàn, nhanh chóng vừa dễ sử dụng.

Tính năng chính

API So sánh tự hào với bộ tính năng phong phú giải quyết các vấn đề khó khăn thường gặp khi điều chỉnh dữ liệu bảng tính trên nhiều nền tảng. Trước hết, API hỗ trợ danh sách đầy đủ các định dạng tệp: Apple Numbers (.numbers), tệp văn bản có dấu phân cách (CSV, TSV), Excel phiên bản cũ (.xls) và Excel hiện đại (.xlsx). Điều này loại bỏ nhu cầu công cụ chuyển đổi trước, cho phép bạn đưa các tệp gốc trực tiếp vào dịch vụ. Engine diff hoạt động ở mức ô, phát hiện thay đổi về giá trị, công thức, và ngay cả các thuộc tính định dạng như kiểu phông chữ, màu nền ô, và quy tắc kiểm tra dữ liệu; mỗi sự chênh lệch được làm nổi bật rõ ràng trong sổ làm việc kết quả bằng các bảng màu có thể tùy chỉnh, giúp người kiểm tra không kỹ thuật dễ dàng giải thích đầu ra. Đối với các bộ dữ liệu quy mô lớn, API cung cấp chế độ so sánh gia tăng, chỉ so sánh các hàng được thêm hoặc chỉnh sửa kể từ bản nền trước, giảm thời gian xử lý và băng thông mạng. Ngoài ra, bạn có thể yêu cầu bản tóm tắt JSON có cấu trúc của các thay đổi bên cạnh tệp diff trực quan, cho phép tự động hóa downstream như kích hoạt cảnh báo, cập nhật bảng điều khiển, hoặc đưa thay đổi vào hệ thống quản lý phiên bản. Các tính năng bảo mật bao gồm xác thực token Bearer OAuth 2.0, khóa API có phạm vi, và tùy chọn whitelist IP, trong khi dữ liệu lưu trữ được mã hoá bằng AES‑256. Dịch vụ còn tuân thủ các tiêu chuẩn tuân thủ GDPR và CCPA, mang lại sự yên tâm khi xử lý thông tin cá nhân hoặc tài chính nhạy cảm. Về hiệu năng, API được thiết kế cho độ trễ thấp; nhờ mở rộng ngang và thuật toán diff trong bộ nhớ, hầu hết các so sánh hoàn thành trong dưới một giây cho sổ làm việc kích thước tiêu chuẩn, với hỗ trợ xử lý bất đồng bộ qua webhook cho các tệp vượt quá 50 MB. Cuối cùng, trải nghiệm nhà phát triển là ưu tiên hàng đầu: các đặc tả OpenAPI toàn diện, SDK tự động sinh, mã lỗi chi tiết, và tiêu đề giới hạn tốc độ thời gian thực giúp bạn tích hợp API một cách trơn tru, trong khi console sandbox và kho mẫu phong phú trình bày các triển khai thực tiễn tốt nhất cho xử lý batch, pipeline CI/CD và hàm serverless. Tóm lại, API So sánh mang lại khả năng diff bảng tính nhanh, an toàn và thân thiện với nhà phát triển, cho phép bạn phát hiện thay đổi bằng một lệnh đơn giản—bất kể định dạng, kích thước hay độ phức tạp của dữ liệu bạn đang xử lý.

Tài liệu

Tham số

format: Một định dạng file đầu ra được hỗ trợ.
UploadFileRequest.OperationId: Đây là một ID hoạt động
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 thủ chuẩn của thẻ input file trong 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 So sánh

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