ファイルをダウンロード
対象アプリ:Workflow、Chatflow。
ファイルの生のバイト列を、プレビューまたはダウンロード用に返します。ファイルは、呼び出し元のアプリ、環境、user に属している必要があります。
標準 API の対応する操作:ファイルをダウンロード。相違点は次のとおりです。
kindパラメータでファイルの取得元を指定します。userが必須です。- エラーコードが異なります。
承認
すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。
キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401(unauthorized)で失敗します。
パスパラメータ
ダウンロードするファイルの ID です。取得元は 2 つあります。ファイルをアップロード のレスポンスで返る id と、会話履歴メッセージ一覧を取得 で返るメッセージの message_files にある各項目の upload_file_id です。ツールが生成したファイルには kind=tool が必要です。
クエリパラメータ
エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。ファイルを所有する user と一致する必要があります。エンドユーザーの識別 を参照してください。
1 - 255true の場合、ファイルはブラウザでインライン表示される代わりに、添付ファイルとしてダウンロードされます。
ファイルの取得元です。メッセージのペイロードで返る URL には、既に正しい値が含まれています。自分で URL を組み立てる場合にのみ、手動で指定します。
upload, tool レスポンス
ファイルの生のコンテンツです。Content-Type はファイル自身の MIME タイプです。as_attachment が true の場合は、application/octet-stream と Content-Disposition: attachment で返します。HTML ファイルは as_attachment の値にかかわらず、常にダウンロードされます。
The response is of type file.