认证
要开始使用我们 API 的端点,您必须先进行认证。本指南解释了如何在 Sheetify Cloud 平台上获取和使用认证凭证。
主要功能
Sheetize Cloud 的认证流程旨在保护您的数据,并确保只有授权用户才能上传文件和调用我们的服务。它提供:
- 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.
使用方法
创建应用程序
- 前往 仪表板
- 登录后,点击左侧导航栏的 **应用** 菜单项。
- 点击 **创建新应用** 打开应用创建表单。
- 在 *应用详情* 部分,为您的应用输入一个描述性名称和简短说明。
- 点击 **保存** 按钮以存储新应用。
- 在应用列表中,找到刚创建的应用并点击其名称。
- 在 *客户端凭证* 面板中,您会看到 **Client ID** 和 **Client Secret**——请妥善保管这些值;获取访问令牌时需要它们。
获取访问令牌
-
向 认证器端点
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - 执行后您将收到令牌,请将其保存以备后用
使用端点
- 选择您想调用的 API。本示例演示转换服务,将电子表格文件转换为 PDF 格式。
-
发送包含文件和访问令牌的请求 转换 API
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' -
服务将返回生成的 PDF 下载链接,例如:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/AFolderName/AFileName.pdf", "message": "", "statusCode": 200 } -
发送包含文件名和文件夹名的请求至 下载 API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.pdf' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - 您将收到文件,既可使用,也可直接转发至工作流的下一步。