dosyaをn8nに接続

n8n-nodes-dosyaコミュニティパッケージはREST APIを通じてn8nをdosyaに接続します。ファイルのアップロード、ダウンロード、一覧表示、フォルダーの作成または再利用、ファイルやフォルダーの共有リンクの作成ができます。

要件と制限

• リポジトリのパッケージはn8n-nodes-dosyaバージョン0.1.1です。互換対象はn8n 2.42とNode.js 22です。コミュニティノードをインストールできるかどうかは、n8nのデプロイポリシーによって異なります。
• ノードにはdosyaのパスワードではなくAPIキーを使います。現在の5つの操作すべてでフルアクセスを使い、REST APIプロトコルを含め、フォルダーへのアクセスを未設定のままにしてください。ワークスペースの固定に対応しています。
• キーのオーナーのワークスペースへの参加状態とロールは引き続き適用されます。フルアクセスのスコープでも、メンバーに許可されていない操作はできません。
• 現在の操作はFile: Upload、File: Download、File: Get Many、Folder: Create、Share Link: Createです。このリリースにはdosyaのトリガー、削除、移動、名前変更、同期、ファイルリクエストの操作はありません。
• プランとワークスペースの制限はdosyaによって適用されます。原文上のFreeプランの標準値はストレージ5 GB、毎日の送信量100 GB、有効な共有リンクは最大5件、共有の有効期限は最長7日です。ワークスペースやファイルごとの上限はさらに厳しい場合があります。

手順

1. コミュニティパッケージを許可するセルフホストのn8nインスタンスで、Settings → Community Nodes → Installを開いてください。
2. n8n-nodes-dosyaを入力し、インストールを確定してください。インストール後、ノード選択画面にdosya.dev、認証情報の選択画面にdosya.dev APIが表示されます。
3. dosyaでプロフィール → API（APIキー） → API：APIキーを作成を開いてください。このn8nインスタンスが分かる名前をキーに付け、フルアクセスを選択し、プロトコルをREST APIに制限します。必要に応じて1つのワークスペースに固定します。
4. キーを生成し、一度だけ表示されるシークレットをコピーしてください。フォルダーアンカーは追加しないでください。APIはWebDAVとS3以外ではフォルダーアンカー付きキーを拒否します。
5. n8nでdosya.dev API認証情報を作成し、API Keyにトークンを入力してください。保存時にGET https://api.dosya.dev/api/meに対してテストされます。
6. 一時的なワークフローを作成し、dosya.devノードを追加してください。保存した認証情報を選び、ResourceにFile、OperationにGet Manyを選択します。
7. WorkspaceでFrom Listを使い、目的の名前を選択してください。FolderでWorkspace Rootを選び、Return Allをオフのままにして、Limitに1などの小さい値を設定します。
8. ノードを実行してください。書き込み操作を追加する前に、返されたworkspace_id、folder_id、id、name、typeを、想定した安全な項目と比較します。

実行結果

認証情報のテストに合格し、試行したGet Manyの実行では、選択したルートから指定した上限以下の項目が返されます。ノードが受け取るのは、キーのオーナーが固定されたワークスペースとロールの範囲内でアクセスできるリソースのみです。

リソースロケーターはFrom ListとBy IDに対応しています。ワークスペースIDはws_、フォルダーIDはfld_、ファイルIDはfile_で始まります。フォルダーの選択肢にはClients / Acme / Finalのようなパスが表示されます。ファイル検索では、文字を入力しない場合はルートの最新ファイルが一覧表示され、文字を入力すると選択したワークスペース全体を50件ずつ検索します。

接続できない場合

• dosya.dev did not accept the API keyは、トークンが不完全、期限切れ、または無効化されている可能性を示します。保存されたn8n認証情報を有効な一度限りのシークレットに置き換えてください。
• **This key is read-only. Uploads, folders and share links need a key with Full access scope.**は、GET /api/meで認証できても、読み取り専用キーの認証情報テストで表示されます。
• api surfaceに言及する403は、キーがRESTを含まないことを示します。REST APIを含むキーを生成してください。
• キーがanchored at a folderと示す403が表示された場合、フォルダーアンカーのないキーに置き換えてください。対象フォルダーはノードで選択します。
• No workspace selectedはn8nの検証エラーです。一覧から選ぶか、ws_…識別子を入力してください。
• ワークスペースが表示されない場合、キーが別のワークスペースに固定されているか、オーナーがメンバーではない可能性があります。認証情報のテストに成功しても、すべてのワークスペースにアクセスできるとは限りません。
• クライアントはRetry-Afterが30秒以下の場合、429を最大3回試行します。待機時間がそれより長い場合、ジョブを通知なく待たせる代わりに実行へ報告します。

n8nパッケージを削除してもdosyaキーは無効化されません。無効化は取り消せませんが、キャッシュ済みの検証成功結果は最大5分受け付けられる場合があります。ローテーション前に影響を受けるワークフローを洗い出し、その期間が過ぎてから再テストしてください。

関連ガイド

• APIキーの権限を選択
• Zapierを接続