KAC fileコンバート
リリース予定:済
最新バージョン:1.0
最新バージョンリリース日:2024/11/01
カスタムコネクタJSONダウンロードURL:
https://drive.google.com/uc?export=download&id=1KmVf8tph1jujcOVSFzrpj1VT8cC5FS2w
仕様・制限事項
KAC のカウントは1リクエストごとに1回カウントアップされます。
最大サイズは約5MBまでです。
アクションによっては、1回の利用であっても分解されるファイルが複数ある場合に複数回の利用回数カウントアップされる場合があります。
KAC APIキーのご利用には、リクエスト回数と処理時間の両方で制限を設けております。大容量のファイルをご利用の場合は特にご注意ください。処理時間が長くなることで、リクエスト回数が上限に達していなくても、APIキーの使用が一時的に制限されることがございます。
サインインに必要な情報
KAC API キー: 寿商会が提供する KAC 専用の API キー
ファイルをBase64に変換
ファイルURLから画像などのデータを取得し、Base64形式のテキストに変換する機能です。
【重要な注意点】
非公開ファイルの場合:fileUrl_headers に認証情報(トークンなど)の設定が必要です
認証情報が正しくない場合、Base64テキストは返されますが使用できません
【簡単な例】
公開ファイル:認証情報は不要です
非公開ファイル:アクセストークンなどの認証情報が必要です
パラメータ
fileUrl: ファイルデータのURL
fileUrl_headers: ファイルURLにアクセスするための認証情報を設定します(fileUrl が共有されているファイルの場合、このフィールドの指定は不要)。例えば、Google Drive 上の共有されていないファイルの場合、「key」には「Authorization」、「value」には「Bearer アクセストークン」のように設定します。
レスポンス
base64EncodedData: Base64エンコードされたテキスト
Base64をファイル化
リクエストで渡されたBase64形式のテキストデータを基に、ファイルを生成し、ダウンロード用のファイルURLを返します。
パラメータ
base64String: Base64形式のテキストデータ
fileName: ファイル名
レスポンス
fileUrl: ダウンロード可能なファイルの URL
URLをプレーンにする
リクエストで渡された共有されていないファイルのURLを基に、そのファイルを共有可能な状態にして、ダウンロード用のURLを返します。
パラメータ
fileUrl_headers: ファイルURLにアクセスするための認証情報を設定します。例えば、Google Drive 上の共有されていないファイルの場合、「key」には「Authorization」、「value」には「Bearer アクセストークン」のように設定します。
fileUrl: ファイルデータのURL
fileName: ファイル名
レスポンス
fileUrl: ダウンロード可能なファイルの URL
ファイルを multipart/form-data で送信
リクエストで渡されたファイルURLを基に、指定したエンドポイントにファイルを multipart/form-data 形式でアップロードします。ファイルデータが共有されていない場合は、fileUrl_headers フィールドにトークンなどの認証情報を設定する必要があります。
パラメータ
fileUrl: ファイルデータのURL
fileUrl_headers: ファイルURLにアクセスするための認証情報を設定します(fileUrl が共有されているファイルの場合、このフィールドの指定は不要)。例えば、Google Drive 上の共有されていないファイルの場合、「key」には「Authorization」、「value」には「Bearer アクセストークン」のように設定します。
fileName: ファイル名
endpoint: エンドポイント(アップロード先のサーバー)のURL
endpoint_headers: エンドポイント(アップロード先のサーバー)にアクセスするための認証情報(例えば、APIキーやトークンなど)
レスポンス
body: アップロード結果のレスポンスボディ
headers: アップロード結果のレスポンスヘッダー