Xác thực

Để bắt đầu sử dụng các endpoint của API của chúng tôi, bạn phải xác thực trước. Hướng dẫn này giải thích cách lấy và sử dụng thông tin xác thực với nền tảng Sheetize Cloud.

Tính năng chính

Quy trình xác thực của Sheetize Cloud được thiết kế để bảo vệ dữ liệu của bạn và đảm bảo chỉ người dùng được ủy quyền mới có thể tải lên tệp và gọi dịch vụ của chúng tôi. Nó cung cấp:

Secure, token-based access that can be revoked at any time.
Support for both machine-to-machine and user-driven scenarios.
Granular scopes that let you limit what a token can do.

Cách sử dụng

Tạo một ứng dụng

Đi tới Bảng điều khiển
Sau khi đăng nhập, nhấp vào mục **Applications** trên thanh điều hướng bên trái.
Nhấn **Create New Application** để mở biểu mẫu tạo ứng dụng.
Trong phần *Application Details*, nhập tên mô tả và mô tả ngắn cho ứng dụng của bạn.
Nhấp vào nút **Save** để lưu ứng dụng mới.
Trong danh sách các ứng dụng, tìm ứng dụng vừa tạo và nhấp vào tên của nó.
Trong bảng *Client Credentials* bạn sẽ thấy **Client ID** và **Client Secret** - giữ các giá trị này an toàn; chúng sẽ cần thiết để lấy token truy cập.

Lấy Token Truy Cập

Thực hiện một yêu cầu tới endpoint Authenticator

https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret
Sau khi thực hiện, bạn sẽ nhận được token, vui lòng lưu lại để sử dụng sau.

Sử dụng các endpoint

Chọn API bạn muốn gọi. Trong ví dụ này, chúng tôi trình bày dịch vụ Conversion, chuyển đổi tệp bảng tính sang định dạng PDF.
Gửi yêu cầu bao gồm các tệp và token truy cập API Conversion

curl -X 'POST' \ 'https://api.sheetize.cloud/conversion/to-pdf' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer The_Secret_Access_Token \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@TestFile.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
Dịch vụ sẽ phản hồi một URL tải xuống cho PDF đã tạo, trong ví dụ này là:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 }
Gửi yêu cầu bao gồm tên tệp và tên thư mục tới API Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -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 bước tiếp theo trong quy trình làm việc.