Zapierからdosyaにファイルをアップロードする

dosyaアプリのUpload File操作で、Zapのトリガーまたは前の操作のファイルをdosyaのクラウドストレージにコピーします。Fileの入力はZapierのファイル参照またはダウンロード可能なURLであり、n8nのバイナリデータや貼り付けたbase64テキストではありません。

非公開アプリの招待を承認してアカウントを接続する

dosyaは現在Zapierの非公開アプリであり、Zapierの公開アプリ検索には表示されません。ワークフローを所有するZapierアカウントにサインインしてください。dosyaのWebアプリで連携 → Zapierを開き、「Zapier」の招待を開くを選択して同じZapierアカウントで招待を承認してください。Zapierの組織が非公開アプリを制限している場合は、Zapを作成する前に管理者にdosyaの承認を依頼してください。ステップの選択画面にdosyaがない場合は設定ページに戻り、現在開いているZapierアカウントで招待を承認したか確認してください。

Zapエディターに戻ってdosya → Upload Fileを追加し、dosya API keyで接続してください。プロフィール → APIキーでキーを作成し、フルアクセスを選択してREST APIを有効にし、フォルダー制限を空欄にしてください。Zapのアクセスを単一のワークスペースに限定する場合はキーをそのワークスペースに限定してください。dosyaのパスワードを使わないでください。接続にはキーのオーナーのメールアドレスが表示されます。

この連携はファイルイベントにも登録するため、認証チェックにはフルアクセスが必要です。権限エラーには**This key has “…” scope. dosya needs a key with full scope to subscribe to file events. Create a full-scope key and reconnect.**と表示されます。フルアクセスキーでも送信先へのメンバーのアップロード権限が必要です。ワークスペースの限定、有効期限、明示的なキーの上限も適用されます。フォルダーに制限されたWebDAV/S3キーはこのREST連携には適しません。

手順：Upload Fileを設定してテストする

1. 新しく機密でないファイルを使ってトリガーまたはファイルを生成する操作をテストしてください。実際のファイル参照または直接ダウンロードURLがサンプルにあるか確認してください。プレビュー、サインイン、通常のクラウド共有ページは目的のファイルではなくHTMLを返す場合があります。
2. dosya → Upload Fileを追加し、接続済みアカウントを選択してください。次の項目を設定します。

操作の項目	選択内容
Workspace（必須）	アカウントで利用できる一覧から目的のワークスペース
Folder（任意）	そのワークスペース内のフォルダー。空欄はワークスペースのルートを意味します。
File（必須）	前のステップのファイル参照、または対話的なサインインなしでZapierがダウンロードできるURL
File name（任意）	zap-proof-20261014.pdfなど拡張子を含む明示的な名前

3. 最初の確認には固有のFile nameを使用してください。項目のヒントには入力元の名前が保持されるとありますが、現在の操作はFile nameが空の場合、実際にはuploadを既定にします。拡張子と種類を維持するには上流のファイル名をマッピングするか入力してください。
4. 操作のテストを1回実行してください。結果のFile ID、File name、Size in bytes、Folder IDを確認し、再テスト前にdosyaでそのファイルを調べてください。
5. Zap全体のトリガーフィルターと後続の操作を確認してください。実際の送信先と繰り返し実行時の動作を確認してからZapを公開・オンにしてください。設定テストが成功すると実際のファイルが書き込まれ、公開しても元には戻りません。

Zapierはファイルオブジェクトを操作用のURLに変換します。dosyaの連携は外部ホストにdosya APIキーを送らずに送信元をダウンロードし、受信したバイトデータをアップロードします。公開URLはファイル内容を直接返し、Zapの実行時に有効である必要があります。有効期限のある参照では古いテストデータを更新してください。ブラウザのCookieが必要なリンクは避け、送信元アプリのファイル・ダウンロード出力を使用してください。HTTP 200のサインイン・プレビューページもファイルとして保存される場合があるため、成功状態だけでなく内容を確認してください。

結果と後続のマッピングを確認する

結果にはid、file_id、name、size、folder_idが含まれ、file_idはidと同じです。選択可能な項目にはFile ID、File name、Size in bytes、Folder IDがあります。最上位へのアップロードのFolder IDはnullです。この操作はversion項目も他のアプリがダウンロードするための遅延fileポインターも返しません。サンプルからどちらもマッピングしないでください。保存したファイルへの操作が必要な場合は別のdosya操作でFile IDを使用してください。

選択したdosyaワークスペースでファイルを開き、対象フォルダーを探して正確な名前と容量を確認してください。サンプルをダウンロードして内容を確認してください。Upload Fileは公開共有リンクを作成しません。別のZapステップで意図的に送信または共有しない限り、受信者には何も届きません。

アップロード上限と再試行

この操作は最大52,428,800バイト（50 MiB）を受け付けます。表示メッセージでは50 MBと呼びます。申告された送信元容量はバッファーに読み込む前に確認され、実際のダウンロード容量も確認されます。Content-Lengthがない場合や展開されたレスポンスは実際のバイト数で測定されます。より大きなファイルにはUpload File From URLを選択してください。この操作を経由せずdosya側でインポートしますが、プランのストレージとアップロードのポリシーは適用されます。

Zapierの操作には30秒の実行期限があるため、上限未満のファイルでもダウンロードとアップロードが遅いとタイムアウトする場合があります。**The app did not respond in-time. It may or may not have completed successfully.**の後は再実行前にdosyaと実行履歴を確認してください。実行に基づく冪等性キーにより、同じアップロードの再試行では保存された結果を再利用できます。新しい実行は別であり、意図的な再実行が元の実行IDを再利用するとは限りません。同じフォルダーに同じ表示名がすでにある場合、dosyaは同名の別ファイルではなく新しいバージョンを書き込みます。バージョン管理する場合は安定した名前、別ファイルが必要な場合はイベント固有の名前を使用してください。

失効したキーでは今後の実行を認可できません。接続アカウントを削除しても、すでに保存したファイルは削除されません。同名の更新は現在の内容を変更するため、本番のファイル名をマッピングする前に専用フォルダーでテストしてください。

テスト失敗からの復旧

失敗	対応
Could not fetch the file: the source at … answered with status …	送信元のURL・アクセスを修正するか、ファイル参照を更新してください。404/500レスポンスはdosyaへのアップロード前に拒否されます。
ファイルにWebページが含まれる	プレビュー・サインインURLを直接のファイル出力に置き換え、新しいテスト名で確認してください。200レスポンスだけでは内容の正しさを確認できません。
This file is larger than 50 MB, which is the limit for the Upload File action.	Upload File From URLに切り替え、インポートサービスから送信元にアクセスでき、プランに容量があることを確認してください。
認証失敗またはフルアクセスを求めるメッセージ	フォルダー制限のない完全で有効なフルアクセスAPIキーで再接続してください。
Workspace/Folderがない、または403	アカウントのメール、ワークスペースの限定、メンバー権限を確認して項目の選択肢を再読み込みしてください。別のワークスペースの似た名前のフォルダーを選ばないでください。
ストレージまたはファイルポリシーによる拒否	再実行前にレスポンスに示された実際のアカウント・ワークスペース・キーの上限を解決してください。
タイムアウト	ファイルやバージョンがすでに保存されたか確認し、より小さい・高速な送信元または非同期のURL操作を使用してください。

期待される結果

テストしたZap操作が実際のFile IDを返し、そのデータが選択したdosyaフォルダーで送信元と一致します。公開後は自動アップロードに依存する前に、最初の実際の実行とファイル名・バージョンの動作を監視してください。

関連ガイド

• Zapierを接続する
• APIキーを管理する