---
id: "zh/api-post-nd-api-file-restore-file"
title: "恢复文件（从回收站）"
language: "zh"
description: "POST /nd/api/file/restore_file：恢复文件（从回收站） 接口说明，包含路径、方法、参数和返回信息。"
canonical_url: "https://www.babel.cc/public/babelwiki/zh/api-post-nd-api-file-restore-file.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-file-restore-file.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-file-restore-file.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-file-restore-file.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# 恢复文件（从回收站）

`POST /nd/api/file/restore_file`

## POST 请求体参数

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `file_ids` | `string[]` | 待恢复文件 ID 集合 |
| `restoreAll` | `boolean` | 未填写 file_ids 且为 true 时恢复全部 |

## 返回信息

原文列出的字段：`code`, `success`.

恢复全部属于大范围操作，执行前确认目标与权限；仅能恢复回收站仍保留的文件。

## 调用说明

使用 `Authorization: Bearer <access_token>`。GET 参数放在 URL 查询串中，普通业务 POST 使用 JSON 请求体。先校验 HTTP 状态，再检查业务结果。数组标记与含糊的类型应按服务端实际约定联调，不应凭示例补造字段。

[认证说明](https://www.babel.cc/public/babelwiki/zh/developer-api-auth.html) · [API 概览](https://www.babel.cc/public/babelwiki/zh/developer-api-overview.html)