認証
API のエンドポイントを使用し始めるには、まず認証が必要です。このガイドでは、Sheetize 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.
使い方
アプリケーションを作成する
- 次へ移動します ダッシュボード
- ログイン後、左側ナビゲーションバーの **Applications** メニュー項目をクリックします。
- **Create New Application** を押して、アプリケーション作成フォームを開きます。
- *Application Details* セクションで、アプリケーションの説明的な名前と短い説明を入力します。
- **Save** ボタンをクリックして新しいアプリケーションを保存します。
- アプリケーション一覧で、作成したものを見つけて名前をクリックします。
- *Client Credentials* パネルに **Client ID** と **Client Secret** が表示されます。これらの値は安全に保管してください。アクセストークン取得時に必要です。
アクセストークンを取得する
-
次のエンドポイントへリクエストを送ります 認証エンドポイント
https://api.sheetize.cloud/authenticator/token?ClientId=TheClientId&ClientSecret=TheClientSecret - 実行後にトークンが返されますので、後で使用できるように保存してください。
エンドポイントを使用する
- 呼び出したい API を選択します。この例では、スプレッドシートファイルを PDF 形式に変換する Conversion サービスをデモします。
-
ファイルとアクセストークンを含むリクエストを送信します 変換 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 のダウンロード URL を返します。この例では次のようになります:
{ "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' - ファイルが返されますので、利用するか、次のワークフローのステップへ転送してください。
