アップロードのみ可能なdosya APIキーを作成する

アップロードのみのREST認証情報では、フォルダーの作成と、状態の問い合わせを含むアップロード処理ができます。同じキーで後からファイルの一覧を表示することはできません。

対応する設定

権限カードには**新しいファイルを追加してください。既存のファイルは読み取りも削除もできません。**と表示されます。REST APIを選択し、可能であればワークスペースに固定してください。フォルダーを指定するとRESTは完全に使えなくなるため、代わりに各アップロード開始リクエストの本文でfolder_idを使って転送先を指定してください。

通常のRESTアップロードには、ワークスペースのロールにupload_filesとaccess_uploadの両方が必要です。SFTPだけはaccess_sftpがゲートウェイを制御するため、access_uploadを経由しません。転送先フォルダーの作成にはさらにcreate_foldersが必要です。

手順

1. **プロフィール → API（APIキー）**を開き、API：APIキーを作成を押して、取り込みジョブに名前を付け、アップロードのみを選択してください。
2. 制限と有効期限でREST APIを有効にし、転送先のワークスペースに固定して、フォルダーは指定しないでください。
3. 一度だけ表示されるシークレットを生成し、POST /api/upload/initと対象のfolder_idを使って固有の名前の小さなテストを開始してください。
4. 返された単一PUTまたはマルチパートのURLでデータを送信し、完了応答のfile.idと実際のsize_bytesを保存してください。
5. アップロード用の認証情報でGET /api/files?workspace_id=wks_…を試し、一覧ではなくスコープによる拒否が返ることを確認してください。
6. 完了時の受領情報、dosyaの画面、または別の信頼できる読み取り用認証情報で新しいファイルを確認し、使い捨てのテストキーであれば取り消してください。

許可される操作と拒否される操作

/api/uploadプレフィックスのすべてはGETの状態確認ルートも含めて書き込み操作に分類されるため、セッションを作成したキーで再開できます。POST /api/foldersも書き込み操作です。通常の読み取り、移動、削除、管理操作はアップロードのみの権限には含まれません。

拒否された一覧リクエストにはThis credential's scope is 'upload' and cannot perform GET /api/filesと表示されます。プロトコル、固定先、ロール、ファイル容量、容量、拡張子、ロック、同時実行のルールによって、アップロードがそれ以前に別のメッセージとともに拒否される場合もあります。

同じ名前の既存ファイルがある場合、完了時に新しいバージョンになることがあります。新規作成のみを目的とする取り込みには固有の転送先名を使用してください。完了するとストレージとファイルのメタデータが確定します。後で削除するには通常のゴミ箱への移動が必要です。

期待される結果

アップロードの受領情報で保存されたファイルを特定し、別の画面で転送先を確認できます。同じキーでワークスペースのファイル一覧を取得しようとすると403が返ります。

関連ガイド

• APIキーを作成する
• キーのスコープを選ぶ